Sdílet prostřednictvím


NetworkStream.WriteAsync Metoda

Definice

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
Zdroj:
NetworkStream.cs
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

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

Výjimky

Nástroj NetworkStream nepodporuje psaní.

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

-nebo-

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

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.

Platí pro

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

Zdroj:
NetworkStream.cs
Zdroj:
NetworkStream.cs
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 size, System::Threading::CancellationToken cancellationToken);
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 size, 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
override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, size As Integer, cancellationToken As CancellationToken) As 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.

sizecount
Int32

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

cancellationToken
CancellationToken

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

Návraty

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

Výjimky

Parametr buffer je null.

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 .

Nástroj NetworkStream nepodporuje psaní.

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

-nebo-

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

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

Platí pro