NetworkStream.WriteAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Name | Beschreibung |
|---|---|
| WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
Schreibt Daten aus einem schreibgeschützten Speicherbytespeicherbereich als asynchronen Vorgang in NetworkStream den Schreibschutzbereich. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Schreibt Daten aus dem angegebenen Bereich eines Bytearrays als asynchronen Vorgang in NetworkStream den angegebenen Bereich. |
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)
Schreibt Daten aus einem schreibgeschützten Speicherbytespeicherbereich als asynchronen Vorgang in NetworkStream den Schreibschutzbereich.
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 ValueTaskParameter
- buffer
- ReadOnlyMemory<Byte>
Ein Speicherbereich, der die zu schreibenden NetworkStreamDaten enthält.
- cancellationToken
- CancellationToken
Das Token, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.
Ausnahmen
Das NetworkStream Schreiben wird nicht unterstützt.
Das NetworkStream ist geschlossen.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Diese Methode sendet alle Bytes an buffer das Netzwerk.
Note
Überprüfen Sie, ob die NetworkStream Eigenschaft schreibbar CanWrite ist. Wenn Sie versuchen, in ein nicht beschreibbares NetworkStream Schreiben zu schreiben, erhalten Sie eine InvalidOperationException.
Note
Wenn Sie eine IOExceptionEigenschaft erhalten, überprüfen Sie die InnerException Eigenschaft, um zu ermitteln, ob sie durch eine SocketException. Wenn ja, verwenden Sie die ErrorCode-Eigenschaft, um den spezifischen Fehlercode abzurufen, und verweisen Sie auf die Windows Sockets Version 2-API-Fehlercodedokumentation, um eine detaillierte Beschreibung des Fehlers zu erhalten.
Gilt für:
WriteAsync(Byte[], Int32, Int32, CancellationToken)
Schreibt Daten aus dem angegebenen Bereich eines Bytearrays als asynchronen Vorgang in NetworkStream den angegebenen Bereich.
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 TaskParameter
- buffer
- Byte[]
Ein Bytearray, das die zu schreibenden NetworkStreamDaten enthält.
- offset
- Int32
Der Speicherort buffer , von dem aus mit dem Schreiben von Daten begonnen werden soll.
- countsize
- Int32
Die Anzahl der Bytes, die in das NetworkStreamGeschrieben werden sollen.
- cancellationToken
- CancellationToken
Das Token, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.
Ausnahmen
Der buffer Parameter ist null.
Der offset Parameter ist kleiner als 0.
-oder-
Der offset Parameter ist größer als die Länge von buffer.
-oder-
Der size Parameter ist kleiner als 0.
-oder-
Der size Parameter ist größer als die Länge minus buffer des Werts des offset Parameters.
Das NetworkStream Schreiben wird nicht unterstützt.
Das NetworkStream ist geschlossen.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Diese Methode beginnt bei der angegebenen offset Methode und sendet count Bytes aus dem Inhalt des buffer Netzwerks.
Note
Überprüfen Sie, ob die NetworkStream Eigenschaft schreibbar CanWrite ist. Wenn Sie versuchen, in ein nicht beschreibbares NetworkStream Schreiben zu schreiben, erhalten Sie eine InvalidOperationException.
Note
Wenn Sie eine IOExceptionEigenschaft erhalten, überprüfen Sie die InnerException Eigenschaft, um zu ermitteln, ob sie durch eine SocketException. Wenn ja, verwenden Sie die ErrorCode-Eigenschaft, um den spezifischen Fehlercode abzurufen, und verweisen Sie auf die Windows Sockets Version 2-API-Fehlercodedokumentation, um eine detaillierte Beschreibung des Fehlers zu erhalten.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(Byte[], Int32, Int32).