NetworkStream.WriteAsync Metode

Definisi

Ruang nama:
System.Net.Sockets
Rakitan:
netstandard.dll, System.Net.Sockets.dll
Rakitan:
System.Net.Sockets.dll
Rakitan:
netstandard.dll

Overload

Nama Deskripsi
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Menulis data ke NetworkStream dari rentang memori byte memori baca-saja sebagai operasi asinkron.
WriteAsync(Byte[], Int32, Int32, CancellationToken)

Menulis data ke NetworkStream dari rentang array byte yang ditentukan sebagai operasi asinkron.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Sumber:
NetworkStream.cs
Sumber:
NetworkStream.cs
Sumber:
NetworkStream.cs
Sumber:
NetworkStream.cs
Sumber:
NetworkStream.cs

Menulis data ke NetworkStream dari rentang memori byte memori baca-saja sebagai operasi asinkron.

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

Parameter

buffer
ReadOnlyMemory<Byte>

Wilayah memori yang berisi data untuk ditulis ke NetworkStream.

cancellationToken
CancellationToken

Token yang akan dipantau untuk permintaan pembatalan.

Mengembalikan

ValueTask

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

InvalidOperationException

NetworkStream Tidak mendukung penulisan.

IOException

Terjadi kesalahan saat mengakses soket.

-atau-

Terjadi kegagalan saat menulis ke jaringan.

ObjectDisposedException

Sudah NetworkStream ditutup.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Metode ini mengirimkan semua byte buffer ke jaringan.

Note

Periksa untuk melihat apakah NetworkStream dapat ditulis dengan memanggil CanWrite properti . Jika Anda mencoba menulis ke yang NetworkStream tidak dapat ditulis, Anda akan mendapatkan InvalidOperationException.

Note

Jika Anda menerima IOException, periksa InnerException properti untuk menentukan apakah itu disebabkan oleh SocketException. Jika demikian, gunakan properti ErrorCode untuk mendapatkan kode kesalahan tertentu dan lihat dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Berlaku untuk

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

Sumber:
NetworkStream.cs
Sumber:
NetworkStream.cs
Sumber:
NetworkStream.cs
Sumber:
NetworkStream.cs
Sumber:
NetworkStream.cs

Menulis data ke NetworkStream dari rentang array byte yang ditentukan sebagai operasi asinkron.

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

Parameter

buffer
Byte[]

Array byte yang berisi data untuk ditulis ke NetworkStream.

offset
Int32

Lokasi tempat buffer untuk mulai menulis data.

countsize
Int32

Jumlah byte yang akan ditulis ke NetworkStream.

cancellationToken
CancellationToken

Token yang akan dipantau untuk permintaan pembatalan.

Mengembalikan

Task

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

ArgumentNullException

Parameternya buffer adalah null.

ArgumentOutOfRangeException

Parameternya offset kurang dari 0.

-atau-

Parameter offset lebih besar dari panjang buffer.

-atau-

Parameternya size kurang dari 0.

-atau-

Parameter size lebih besar dari panjang buffer dikurangi nilai offset parameter.

InvalidOperationException

NetworkStream Tidak mendukung penulisan.

IOException

Terjadi kegagalan saat menulis ke jaringan.

-atau-

Terjadi kesalahan saat mengakses soket.

ObjectDisposedException

Sudah NetworkStream ditutup.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Metode ini dimulai pada byte yang ditentukan offset dan mengirim count byte dari konten buffer ke jaringan.

Note

Periksa untuk melihat apakah NetworkStream dapat ditulis dengan memanggil CanWrite properti . Jika Anda mencoba menulis ke yang NetworkStream tidak dapat ditulis, Anda akan mendapatkan InvalidOperationException.

Note

Jika Anda menerima IOException, periksa InnerException properti untuk menentukan apakah itu disebabkan oleh SocketException. Jika demikian, gunakan properti ErrorCode untuk mendapatkan kode kesalahan tertentu dan lihat dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Write(Byte[], Int32, Int32).

Berlaku untuk