NetworkStream Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt de onderliggende gegevensstroom voor netwerktoegang.
public ref class NetworkStream : System::IO::Streampublic class NetworkStream : System.IO.Streamtype NetworkStream = class
inherit Stream
interface IDisposabletype NetworkStream = class
inherit StreamPublic Class NetworkStream
Inherits Stream- Overname
- Overname
- Implementeringen
Opmerkingen
De NetworkStream klasse biedt methoden voor het verzenden en ontvangen van gegevens via Stream sockets in de blokkeringsmodus. Zie Een Asynchrone clientsocket gebruiken voor meer informatie over blokkeren versus niet-blokkerende Sockets. U kunt de NetworkStream klasse gebruiken voor zowel synchrone als asynchrone gegevensoverdracht. Zie Sockets voor meer informatie over synchrone en asynchrone communicatie.
Als u een NetworkStreamwilt maken, moet u een verbonden Socket. U kunt ook opgeven welke FileAccess machtiging de NetworkStream heeft ten opzichte van de opgegeven Socket. Als u de opgegeven gegevens sluit, sluit u de NetworkStream opgegeven Socketstandaard niet. Als u wilt dat de NetworkStream opgegeven machtiging is om de opgegeven Socketwaarde te sluiten, moet u opgeven true voor de waarde van de ownsSocket parameter.
Gebruik de Write en Read methoden voor eenvoudige synchrone blokkerende I/O met één thread. Als u uw I/O asynchroon wilt verwerken, kunt u overwegen de Task of -gebaseerde methoden ReadAsync te gebruiken en WriteAsyncValueTask.
De NetworkStream service biedt geen ondersteuning voor willekeurige toegang tot de netwerkgegevensstroom. De waarde van de CanSeek eigenschap, die aangeeft of de stroom zoeken ondersteunt, is altijd false; het lezen van de Position eigenschap, het lezen van de Length eigenschap of het aanroepen van de Seek methode genereert een NotSupportedException.
Lees- en schrijfbewerkingen kunnen tegelijkertijd worden uitgevoerd op een exemplaar van de NetworkStream klasse zonder dat er synchronisatie nodig is. Zolang er één unieke thread is voor de schrijfbewerkingen en één unieke thread voor de leesbewerkingen, is er geen kruisinterferentie tussen lees- en schrijfthreads en is er geen synchronisatie vereist.
Constructors
| Name | Description |
|---|---|
| NetworkStream(Socket, Boolean) |
Initialiseert een nieuw exemplaar van de NetworkStream klasse voor de opgegeven Socket klasse met het opgegeven Socket eigendom. |
| NetworkStream(Socket, FileAccess, Boolean) |
Hiermee maakt u een nieuw exemplaar van de NetworkStream klasse voor de opgegeven Socket met de opgegeven toegangsrechten en het opgegeven Socket eigendom. |
| NetworkStream(Socket, FileAccess) |
Hiermee maakt u een nieuw exemplaar van de NetworkStream klasse voor de opgegeven Socket met de opgegeven toegangsrechten. |
| NetworkStream(Socket) |
Hiermee maakt u een nieuw exemplaar van de NetworkStream klasse voor de opgegeven Socket. |
Eigenschappen
| Name | Description |
|---|---|
| CanRead |
Hiermee wordt een waarde opgehaald die aangeeft of het NetworkStream lezen wordt ondersteund. |
| CanSeek |
Hiermee wordt een waarde opgehaald die aangeeft of de stream het zoeken ondersteunt. Deze eigenschap wordt momenteel niet ondersteund. Deze eigenschap retourneert |
| CanTimeout |
Geeft aan of time-outeigenschappen bruikbaar zijn voor NetworkStream. |
| CanWrite |
Hiermee wordt een waarde opgehaald die aangeeft of het NetworkStream schrijven wordt ondersteund. |
| DataAvailable |
Hiermee wordt een waarde opgehaald die aangeeft of gegevens beschikbaar zijn op de NetworkStream gegevens die onmiddellijk moeten worden gelezen. |
| Length |
Hiermee haalt u de lengte op van de gegevens die beschikbaar zijn in de stream. Deze eigenschap wordt momenteel niet ondersteund en genereert altijd een NotSupportedException. |
| Position |
Hiermee haalt u de huidige positie in de stroom op of stelt u deze in. Deze eigenschap wordt momenteel niet ondersteund en genereert altijd een NotSupportedException. |
| Readable |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de NetworkStream waarde kan worden gelezen. |
| ReadTimeout |
Hiermee wordt de hoeveelheid tijd opgehaald of ingesteld die een leesbewerking blokkeert voor het wachten op gegevens. |
| Socket |
Hiermee haalt u de onderliggende Socketwaarde op. |
| Writeable |
Hiermee wordt een waarde opgehaald die aangeeft of het NetworkStream beschrijfbaar is. |
| WriteTimeout |
Hiermee wordt de hoeveelheid tijd opgehaald of ingesteld die een schrijfbewerking blokkeert die wacht op gegevens. |
Methoden
| Name | Description |
|---|---|
| BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) |
Begint een asynchrone leesbewerking uit de NetworkStream. |
| BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) |
Hiermee wordt een asynchrone schrijfbewerking naar een stream gestart. |
| Close() |
Hiermee sluit u de NetworkStream. |
| Close() |
Hiermee sluit u de huidige stroom en worden alle resources (zoals sockets en bestandsingangen) die aan de huidige stroom zijn gekoppeld, vrijgegeven. In plaats van deze methode aan te roepen, moet u ervoor zorgen dat de stream correct wordt verwijderd. (Overgenomen van Stream) |
| Close(Int32) |
Hiermee sluit u de NetworkStream bewerking nadat u de opgegeven tijd hebt gewacht om toe te staan dat gegevens worden verzonden. |
| CopyTo(Stream, Int32) |
Leest de bytes uit de huidige stream en schrijft ze naar een andere stroom, met behulp van een opgegeven buffergrootte. Beide streamsposities worden geavanceerd door het aantal gekopieerde bytes. (Overgenomen van Stream) |
| CopyTo(Stream) |
Leest de bytes uit de huidige stream en schrijft ze naar een andere stream. Beide streamsposities worden geavanceerd door het aantal gekopieerde bytes. (Overgenomen van Stream) |
| CopyToAsync(Stream, CancellationToken) |
Asynchroon leest de bytes uit de huidige stream en schrijft deze naar een andere stream met behulp van een opgegeven annuleringstoken. Beide streamsposities worden geavanceerd door het aantal gekopieerde bytes. (Overgenomen van Stream) |
| CopyToAsync(Stream, Int32, CancellationToken) |
Asynchroon leest de bytes uit de huidige stream en schrijft deze naar een andere stroom, met behulp van een opgegeven buffergrootte en annuleringstoken. Beide streamsposities worden geavanceerd door het aantal gekopieerde bytes. (Overgenomen van Stream) |
| CopyToAsync(Stream, Int32) |
Asynchroon leest de bytes uit de huidige stream en schrijft deze naar een andere stroom, met behulp van een opgegeven buffergrootte. Beide streamsposities worden geavanceerd door het aantal gekopieerde bytes. (Overgenomen van Stream) |
| CopyToAsync(Stream) |
Asynchroon leest de bytes uit de huidige stream en schrijft ze naar een andere stream. Beide streamsposities worden geavanceerd door het aantal gekopieerde bytes. (Overgenomen van Stream) |
| CreateObjRef(Type) |
Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object. (Overgenomen van MarshalByRefObject) |
| CreateWaitHandle() |
Verouderd.
Wijst een WaitHandle object toe. (Overgenomen van Stream) |
| Dispose() |
Alle resources die worden gebruikt door de Stream. (Overgenomen van Stream) |
| Dispose(Boolean) |
Publiceert de niet-beheerde resources die worden gebruikt door de NetworkStream beheerde resources en brengt eventueel de beheerde resources vrij. |
| DisposeAsync() |
Geeft asynchroon de onbeheerde resources vrij die worden gebruikt door de Stream. (Overgenomen van Stream) |
| EndRead(IAsyncResult) |
Verwerkt het einde van een asynchrone leesbewerking. |
| EndWrite(IAsyncResult) |
Verwerkt het einde van een asynchrone schrijfbewerking. |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| Finalize() |
Alle resources die worden gebruikt door de NetworkStream. |
| Flush() |
Hiermee worden gegevens uit de stream leeggemaakt. Deze methode is gereserveerd voor toekomstig gebruik. |
| FlushAsync() |
Asynchroon wist alle buffers voor deze stroom en zorgt ervoor dat eventuele gebufferde gegevens naar het onderliggende apparaat worden geschreven. (Overgenomen van Stream) |
| FlushAsync(CancellationToken) |
Hiermee worden gegevens uit de stream leeggemaakt als een asynchrone bewerking. |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetLifetimeService() |
Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd. (Overgenomen van MarshalByRefObject) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| InitializeLifetimeService() |
Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren. (Overgenomen van MarshalByRefObject) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| MemberwiseClone(Boolean) |
Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object. (Overgenomen van MarshalByRefObject) |
| ObjectInvariant() |
Verouderd.
Biedt ondersteuning voor een Contract. (Overgenomen van Stream) |
| Read(Byte[], Int32, Int32) |
Hiermee worden gegevens uit de NetworkStream gegevens gelezen en opgeslagen in een bytematrix. |
| Read(Span<Byte>) |
Hiermee worden gegevens uit de NetworkStream gegevens gelezen en opgeslagen in een groot aantal bytes in het geheugen. |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Hiermee worden gegevens uit de NetworkStream gegevens gelezen en opgeslagen in een opgegeven bereik van een bytematrix als asynchrone bewerking. |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Asynchroon leest een reeks bytes uit de huidige stroom, verplaatst de positie binnen de stream door het aantal gelezen bytes en bewaakt annuleringsaanvragen. (Overgenomen van Stream) |
| ReadAsync(Byte[], Int32, Int32) |
Asynchroon leest een reeks bytes uit de huidige stroom en wordt de positie binnen de stream verplaatst door het aantal gelezen bytes. (Overgenomen van Stream) |
| ReadAsync(Memory<Byte>, CancellationToken) |
Leest gegevens uit de NetworkStream gegevens en slaat deze op in een bytegeheugenbereik als asynchrone bewerking. |
| ReadByte() |
Hiermee leest u een byte uit de NetworkStream en wordt de positie binnen de stream met één byte gelezen of wordt -1 geretourneerd als aan het einde van de stream. |
| ReadByte() |
Hiermee leest u een byte uit de stroom en wordt de positie binnen de stream met één byte vooruit gelezen of wordt -1 geretourneerd als aan het einde van de stream. (Overgenomen van Stream) |
| Seek(Int64, SeekOrigin) |
Hiermee stelt u de huidige positie van de stroom in op de opgegeven waarde. Deze methode wordt momenteel niet ondersteund en genereert altijd een NotSupportedException. |
| SetLength(Int64) |
Hiermee stelt u de lengte van de stream in. Deze methode gooit altijd een NotSupportedException. |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
| Write(Byte[], Int32, Int32) |
Hiermee schrijft u gegevens naar het NetworkStream opgegeven bereik van een bytematrix. |
| Write(ReadOnlySpan<Byte>) |
Hiermee schrijft u gegevens naar de NetworkStream gegevens van een bytespanne met het kenmerk Alleen-lezen. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Hiermee schrijft u gegevens naar het NetworkStream opgegeven bereik van een bytematrix als asynchrone bewerking. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Asynchroon schrijft een reeks bytes naar de huidige stroom, verplaatst de huidige positie binnen deze stream door het aantal geschreven bytes en bewaakt annuleringsaanvragen. (Overgenomen van Stream) |
| WriteAsync(Byte[], Int32, Int32) |
Asynchroon schrijft een reeks bytes naar de huidige stroom en wordt de huidige positie binnen deze stroom verplaatst door het aantal geschreven bytes. (Overgenomen van Stream) |
| WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
Hiermee schrijft u gegevens naar het NetworkStream geheugenbereik van een alleen-lezen geheugen byte als asynchrone bewerking. |
| WriteByte(Byte) |
Hiermee schrijft u een byte naar de huidige positie in de NetworkStream stroom en wordt de positie binnen de stream met één byte vooruit. |
| WriteByte(Byte) |
Hiermee schrijft u een byte naar de huidige positie in de stroom en wordt de positie binnen de stream met één byte vooruit. (Overgenomen van Stream) |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| IDisposable.Dispose() |
Deze API ondersteunt de productinfrastructuur en is niet bedoeld om rechtstreeks vanuit de code te gebruiken. Alle resources die worden gebruikt door de NetworkStream. |
Extensiemethoden
| Name | Description |
|---|---|
| ConfigureAwait(IAsyncDisposable, Boolean) |
Hiermee configureert u hoe wacht op de taken die worden geretourneerd op basis van een asynchroon wegwerp, worden uitgevoerd. |