NetworkStream.WriteAsync Metódus

Definíció

Névtér:: System.Net.Sockets

Szerelvények:: netstandard.dll, System.Net.Sockets.dll

Szerelvény:: System.Net.Sockets.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Túlterhelések

Name	Description
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Adatokat ír egy NetworkStream írásvédett memória bájt memóriatartományából aszinkron műveletként.
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Adatokat ír a NetworkStream bájttömb megadott tartományából aszinkron műveletként.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Forrás:: NetworkStream.cs

Forrás:: NetworkStream.cs

Forrás:: NetworkStream.cs

Forrás:: NetworkStream.cs

Forrás:: NetworkStream.cs

Adatokat ír egy NetworkStream írásvédett memória bájt memóriatartományából aszinkron műveletként.

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

Paraméterek

buffer: ReadOnlyMemory<Byte>

A memóriának az a régiója, amely a beírandó NetworkStreamadatokat tartalmazza.

cancellationToken: CancellationToken

A lemondási kérelmek figyelésére szolgáló jogkivonat.

Válaszok

ValueTask

Az aszinkron írási műveletet képviselő feladat.

Kivételek

InvalidOperationException

Ez NetworkStream nem támogatja az írást.

IOException

Hiba történt a szoftvercsatorna elérésekor.

-vagy-

Hiba történt a hálózatba való írás közben.

ObjectDisposedException

A NetworkStream lezárva.

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

Megjegyzések

Ez a metódus az összes bájtot elküldi buffer a hálózatnak.

Note

Ellenőrizze, hogy a NetworkStream tulajdonság meghívásával írható-e.CanWrite Ha olyanba próbál írni NetworkStream , amely nem írható, kap egy InvalidOperationException.

Note

Ha kap egy tulajdonságot IOException, ellenőrizze a InnerException tulajdonságot annak megállapításához, hogy a tulajdonságot egy SocketException. Ha igen, a ErrorCode tulajdonsággal szerezze be az adott hibakódot, és a hiba részletes leírásához tekintse meg a Windows Sockets 2-es verziójának API hibakóddokumentációját.

A következőre érvényes:

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

Forrás:: NetworkStream.cs

Forrás:: NetworkStream.cs

Forrás:: NetworkStream.cs

Forrás:: NetworkStream.cs

Forrás:: NetworkStream.cs

Adatokat ír a NetworkStream bájttömb megadott tartományából aszinkron műveletként.

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(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 count, System.Threading.CancellationToken cancellationToken);

public override System.Threading.Tasks.Task WriteAsync(byte[] buffer, int offset, int size, 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, count As Integer, cancellationToken As CancellationToken) As Task

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

Paraméterek

buffer: Byte[]

Egy bájttömb, amely tartalmazza a beírandó NetworkStreamadatokat.

offset: Int32

Az a hely buffer , ahonnan az adatok írása elkezdhető.

countsize: Int32

A beírandó NetworkStreambájtok száma.

cancellationToken: CancellationToken

A lemondási kérelmek figyelésére szolgáló jogkivonat.

Válaszok

Task

Az aszinkron írási műveletet képviselő feladat.

Kivételek

ArgumentNullException

A buffer paraméter a következő null: .

ArgumentOutOfRangeException

A offset paraméter kisebb, mint 0.

-vagy-

A offset paraméter nagyobb, mint a hossza buffer.

-vagy-

A size paraméter kisebb, mint 0.

-vagy-

A size paraméter nagyobb, mint a paraméter értékének bufferoffset mínusz hossza.

InvalidOperationException

Ez NetworkStream nem támogatja az írást.

IOException

Hiba történt a hálózatba való írás közben.

-vagy-

Hiba történt a szoftvercsatorna elérésekor.

ObjectDisposedException

A NetworkStream lezárva.

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

Megjegyzések

Ez a metódus a megadott offset időponttól indul, és bájtokat küld count a hálózat tartalmából buffer .

Note

Ellenőrizze, hogy a NetworkStream tulajdonság meghívásával írható-e.CanWrite Ha olyanba próbál írni NetworkStream , amely nem írható, kap egy InvalidOperationException.

Note

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által Write(Byte[], Int32, Int32)kiadott kivételeket: .

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?