Bagikan melalui

NetworkStream.ReadAsync Metode

  • Referensi

Definisi

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

Overload

ReadAsync(Memory<Byte>, CancellationToken)

Membaca data dari NetworkStream dan menyimpannya dalam rentang memori byte sebagai operasi asinkron.
ReadAsync(Byte[], Int32, Int32, CancellationToken)

Membaca data dari NetworkStream dan menyimpannya ke rentang array byte tertentu sebagai operasi asinkron.

ReadAsync(Memory<Byte>, CancellationToken)

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

Membaca data dari NetworkStream dan menyimpannya dalam rentang memori byte sebagai operasi asinkron.

public override System.Threading.Tasks.ValueTask<int> ReadAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);
override this.ReadAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
Public Overrides Function ReadAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parameter

buffer
Memory<Byte>

Buffer untuk menulis data.

cancellationToken
CancellationToken

Token yang akan dipantau untuk permintaan pembatalan.

Mengembalikan

ValueTask<Int32>

ValueTask<TResult> yang mewakili operasi baca asinkron. Nilai propertinya Result berisi jumlah total byte yang dibaca ke dalam buffer.

Pengecualian

InvalidOperationException

NetworkStream tidak mendukung pembacaan.

IOException

Terjadi kesalahan saat mengakses soket.

-atau-

Ada kegagalan membaca dari jaringan.

ObjectDisposedException

Sudah NetworkStream ditutup.

OperationCanceledException

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

Keterangan

Metode ini membaca data sebanyak yang tersedia dan buffer mengembalikan jumlah byte yang berhasil dibaca.

Catatan

Periksa untuk melihat apakah NetworkStream dapat dibaca dengan memanggil CanRead properti . Jika Anda mencoba membaca dari NetworkStream yang tidak dapat dibaca, Anda akan mendapatkan InvalidOperationException.

Catatan

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

Berlaku untuk

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

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

Membaca data dari NetworkStream dan menyimpannya ke rentang array byte tertentu sebagai operasi asinkron.

public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int size, System::Threading::CancellationToken cancellationToken);
public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<int> ReadAsync (byte[] buffer, int offset, int size, System.Threading.CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<int> ReadAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);
override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, size As Integer, cancellationToken As CancellationToken) As Task(Of Integer)
Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task(Of Integer)

Parameter

buffer
Byte[]

Buffer untuk menulis data ke dalamnya.

offset
Int32

Lokasi di buffer untuk mulai menyimpan data.

sizecount
Int32

Jumlah byte yang akan dibaca dari NetworkStream.

cancellationToken
CancellationToken

Token yang akan dipantau untuk permintaan pembatalan.

Mengembalikan

Task<Int32>

Tugas yang mewakili operasi baca asinkron. Nilai propertinya Result berisi jumlah total byte yang dibaca ke dalam buffer.

Pengecualian

InvalidOperationException

NetworkStream tidak mendukung pembacaan.

IOException

Terjadi kesalahan saat mengakses soket.

-atau-

Ada kegagalan membaca dari jaringan.

ObjectDisposedException

Sudah NetworkStream ditutup.

OperationCanceledException

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

Keterangan

Metode ini membaca data ke dalam buffer dan mengembalikan jumlah byte yang berhasil dibaca. Operasi ini ReadAsync membaca data sebanyak yang tersedia, hingga jumlah byte yang ditentukan oleh size parameter .

Catatan

Periksa untuk melihat apakah NetworkStream dapat dibaca dengan memanggil CanRead properti . Jika Anda mencoba membaca dari NetworkStream yang tidak dapat dibaca, Anda akan mendapatkan InvalidOperationException.

Catatan

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

Metode ini disimpan dalam tugas yang menampilkan 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 Read(Byte[], Int32, Int32).

Berlaku untuk