NetworkStream.WriteAsync Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

netstandard.dll, System.Net.Sockets.dll

Přetížení

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

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Zdroj:

NetworkStream.cs

Zapisuje data z bajtové oblasti paměti jen pro NetworkStream č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 objektu NetworkStream.

cancellationToken

CancellationToken

Token pro monitorování žádostí o zrušení.

Návraty

ValueTask

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

Výjimky

InvalidOperationException

Nepodporuje NetworkStream 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

To NetworkStream je uzavřeno.

OperationCanceledException

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

Poznámky

Tato metoda odesílá do sítě všechny bajty buffer .

Note

Zkontrolujte, jestli NetworkStream je zapisovatelná voláním CanWrite vlastnosti. Pokud se pokusíte napsat na NetworkStream to, který není zapisovatelný, dostanete .InvalidOperationException

Note

Pokud obdržíte , IOExceptionzkontrolujte InnerException vlastnost a zjistěte, zda byla způsobena SocketException. Pokud ano, použijte vlastnost ErrorCode k získání konkrétního kódu chyby a v dokumentaci k chybě rozhraní API Windows Sockets verze 2 vyhledejte podrobný popis chyby.

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

Zdroj:

NetworkStream.cs

Zapisuje data do NetworkStream zadané oblasti bajtového pole 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í zapisovat do objektu NetworkStream.

offset

Int32

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

count

Int32

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

cancellationToken

CancellationToken

Token pro monitorování žádostí 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 buffer.

nebo

Parametr size je menší než 0.

nebo

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

InvalidOperationException

Nepodporuje NetworkStream 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

To NetworkStream je uzavřeno.

OperationCanceledException

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

Poznámky

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

Note

Zkontrolujte, jestli NetworkStream je zapisovatelná voláním CanWrite vlastnosti. Pokud se pokusíte napsat na NetworkStream to, který není zapisovatelný, dostanete .InvalidOperationException

Note

Pokud obdržíte , IOExceptionzkontrolujte InnerException vlastnost a zjistěte, zda byla způsobena SocketException. Pokud ano, použijte vlastnost ErrorCode k získání konkrétního kódu chyby a v dokumentaci k chybě rozhraní API Windows Sockets verze 2 vyhledejte podrobný popis chyby.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané Write(Byte[], Int32, Int32).