NetworkStream.WriteAsync Methode
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.
Overloads
| Name | Description |
|---|---|
| WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
Hiermee schrijft u gegevens naar het NetworkStream geheugenbereik van een alleen-lezen geheugen byte als asynchrone bewerking. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Hiermee schrijft u gegevens naar het NetworkStream opgegeven bereik van een bytematrix als asynchrone bewerking. |
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)
Hiermee schrijft u gegevens naar het NetworkStream geheugenbereik van een alleen-lezen geheugen byte als asynchrone bewerking.
public override System.Threading.Tasks.ValueTask WriteAsync(ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParameters
- buffer
- ReadOnlyMemory<Byte>
Een geheugengebied met de gegevens die moeten worden geschreven naar de NetworkStream.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Een taak die de asynchrone schrijfbewerking vertegenwoordigt.
Uitzonderingen
Het NetworkStream biedt geen ondersteuning voor schrijven.
Er is een fout opgetreden bij het openen van de socket.
– of –
Er is een fout opgetreden tijdens het schrijven naar het netwerk.
De NetworkStream is gesloten.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Met deze methode worden alle bytes naar buffer het netwerk verzonden.
Note
Controleer of het NetworkStream beschrijfbaar is door de eigenschap aan te CanWrite roepen. Als u probeert te schrijven naar een NetworkStream die niet beschrijfbaar is, krijgt u een InvalidOperationException.
Note
Als u een IOException, controleert u de InnerException eigenschap om te bepalen of deze is veroorzaakt door een SocketException. Als dit het probleem is, gebruikt u de eigenschap ErrorCode om de specifieke foutcode te verkrijgen en raadpleegt u de documentatie over de Windows Sockets versie 2 API-foutcode voor een gedetailleerde beschrijving van de fout.
Van toepassing op
WriteAsync(Byte[], Int32, Int32, CancellationToken)
Hiermee schrijft u gegevens naar het NetworkStream opgegeven bereik van een bytematrix als asynchrone bewerking.
public:
override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int size, System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task WriteAsync(byte[] buffer, int offset, int size, System.Threading.CancellationToken cancellationToken);abstract member WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Taskoverride this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function WriteAsync (buffer As Byte(), offset As Integer, size As Integer, cancellationToken As CancellationToken) As TaskParameters
- buffer
- Byte[]
Een bytematrix die de gegevens bevat die naar het NetworkStreambestand moeten worden geschreven.
- offset
- Int32
De locatie buffer waar u gegevens wilt gaan schrijven.
- countsize
- Int32
Het aantal bytes dat moet worden geschreven naar de NetworkStream.
- cancellationToken
- CancellationToken
Het token dat moet worden gecontroleerd op annuleringsaanvragen.
Retouren
Een taak die de asynchrone schrijfbewerking vertegenwoordigt.
Uitzonderingen
De buffer parameter is null.
De offset parameter is kleiner dan 0.
– of –
De offset parameter is groter dan de lengte van buffer.
– of –
De size parameter is kleiner dan 0.
– of –
De size parameter is groter dan de lengte van buffer min de waarde van de offset parameter.
Het NetworkStream biedt geen ondersteuning voor schrijven.
Er is een fout opgetreden tijdens het schrijven naar het netwerk.
– of –
Er is een fout opgetreden bij het openen van de socket.
De NetworkStream is gesloten.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Deze methode begint bij de opgegeven offset en verzendt count bytes van de inhoud naar buffer het netwerk.
Note
Controleer of het NetworkStream beschrijfbaar is door de eigenschap aan te CanWrite roepen. Als u probeert te schrijven naar een NetworkStream die niet beschrijfbaar is, krijgt u een InvalidOperationException.
Note
Als u een IOException, controleert u de InnerException eigenschap om te bepalen of deze is veroorzaakt door een SocketException. Als dit het probleem is, gebruikt u de eigenschap ErrorCode om de specifieke foutcode te verkrijgen en raadpleegt u de documentatie over de Windows Sockets versie 2 API-foutcode voor een gedetailleerde beschrijving van de fout.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Write(Byte[], Int32, Int32)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.