NetworkStream.WriteAsync Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

System.Net.Sockets.dll

Přetížení

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Zapisuje data z NetworkStream oblasti bajtové paměti jen pro čtení jako asynchronní operace.
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Zapisuje data ze NetworkStream zadaného rozsahu pole bajtů jako asynchronní operace.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Zdroj:

NetworkStream.cs

Zapisuje data z NetworkStream oblasti bajtové paměti jen pro čtení jako asynchronní operace.

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.ValueTask

Public Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parametry

buffer

ReadOnlyMemory<Byte>

Oblast paměti, která obsahuje data pro zápis do NetworkStream.

cancellationToken

CancellationToken

Token, který se má monitorovat pro žádosti o zrušení.

Návraty

ValueTask

Úloha, která představuje asynchronní operaci zápisu.

Výjimky

InvalidOperationException

Nástroj NetworkStream nepodporuje psaní.

IOException

Při přístupu k soketu došlo k chybě.

-nebo-

Při zápisu do sítě došlo k chybě.

ObjectDisposedException

Je NetworkStream zavřený.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato metoda odešle všechny bajty do buffer sítě.

Poznámka

Voláním CanWrite vlastnosti zkontrolujte, jestli NetworkStream je zapisovatelný. Pokud se pokusíte zapisovat na NetworkStream objekt, který není zapisovatelný, získáte .InvalidOperationException

Poznámka

Pokud se zobrazí , IOExceptionzkontrolujte vlastnost a InnerException zjistěte, jestli byla způsobená objektem SocketException. Pokud ano, použijte ErrorCode vlastnost k získání konkrétního kódu chyby a podrobný popis chyby najdete v dokumentaci ke kódu chyby rozhraní API windows Sockets verze 2.

WriteAsync(Byte[], Int32, Int32, CancellationToken)

Zdroj:

NetworkStream.cs

Zapisuje data ze NetworkStream zadaného rozsahu pole bajtů jako asynchronní operace.

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task WriteAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);

override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task

Parametry

buffer

Byte[]

Bajtové pole obsahující data, která se mají zapsat do NetworkStream.

offset

Int32

Umístění, ze buffer kterého chcete začít zapisovat data.

count

Int32

Počet bajtů, které se mají zapsat do NetworkStream.

cancellationToken

CancellationToken

Token, který se má monitorovat pro žádosti o zrušení.

Návraty

Task

Úloha, která představuje asynchronní operaci zápisu.

Výjimky

ArgumentNullException

Parametr buffer je null.

ArgumentOutOfRangeException

Parametr offset je menší než 0.

-nebo-

Parametr offset je větší než délka parametru buffer.

-nebo-

Parametr size je menší než 0.

-nebo-

Parametr size je větší než délka buffer minus hodnota parametru offset .

InvalidOperationException

Nástroj NetworkStream nepodporuje psaní.

IOException

Při zápisu do sítě došlo k chybě.

-nebo-

Při přístupu k soketu došlo k chybě.

ObjectDisposedException

Je NetworkStream zavřený.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato metoda začíná na zadaném offset a odesílá size bajty z obsahu buffer do sítě.

Poznámka

Voláním CanWrite vlastnosti zkontrolujte, jestli NetworkStream je zapisovatelný. Pokud se pokusíte zapisovat na NetworkStream objekt, který není zapisovatelný, získáte .InvalidOperationException

Poznámka

Pokud se zobrazí , IOExceptionzkontrolujte vlastnost a InnerException zjistěte, jestli byla způsobená objektem SocketException. Pokud ano, použijte ErrorCode vlastnost k získání konkrétního kódu chyby a podrobný popis chyby najdete v dokumentaci ke kódu chyby rozhraní API windows Sockets verze 2.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Write(Byte[], Int32, Int32).