SslStream.ReadAsync Metode

Definisi

Ruang nama:

System.Net.Security

Rakitan:

System.Net.Security.dll

Overload

ReadAsync(Memory<Byte>, CancellationToken)	Secara asinkron membaca data dari aliran ini dan menyimpannya dalam rentang memori yang ditentukan.
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Secara asinkron membaca data dari aliran ini dan menyimpannya dalam rentang array byte yang ditentukan.

ReadAsync(Memory<Byte>, CancellationToken)

Sumber:

SslStream.cs

Secara asinkron membaca data dari aliran ini dan menyimpannya dalam rentang memori yang ditentukan.

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 yang menerima byte yang dibaca dari aliran ini.

cancellationToken

CancellationToken

Token yang akan dipantau untuk permintaan pembatalan.

Mengembalikan

ValueTask<Int32>

Tugas yang mewakili operasi baca asinkron. Nilai propertinya Result berisi jumlah total byte yang dibaca ke dalam buffer. Ketika tidak ada lagi data yang akan dibaca, mengembalikan 0.

Pengecualian

InvalidOperationException

Autentikasi belum terjadi.

IOException

Operasi baca gagal. Periksa pengecualian dalam, jika ada, untuk menentukan penyebab kegagalan.

NotSupportedException

Sudah ada operasi baca yang sedang berlangsung.

ObjectDisposedException

Objek ini telah ditutup.

OperationCanceledException

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

Keterangan

Metode ini membaca data sebanyak yang tersedia ke bufferdalam .

Anda tidak dapat melakukan beberapa operasi baca simultan.

Anda tidak dapat memanggil metode ini sampai Anda berhasil mengautentikasi.

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

Sumber:

SslStream.cs

Secara asinkron membaca data dari aliran ini dan menyimpannya dalam rentang array byte yang ditentukan.

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

override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task(Of Integer)

Parameter

buffer

Byte[]

Buffer yang menerima byte yang dibaca dari aliran ini.

offset

Int32

Lokasi berbasis nol tempat buffer mulai menyimpan data yang dibaca dari aliran ini.

count

Int32

Jumlah maksimum byte yang akan dibaca dari aliran ini.

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. Ketika tidak ada lagi data yang akan dibaca, mengembalikan 0.

Pengecualian

ArgumentNullException

bufferadalah null.

ArgumentOutOfRangeException

offset kurang dari 0.

-atau-

count kurang dari 0.

-atau-

count lebih besar dari panjang buffer minus offset.

InvalidOperationException

Autentikasi belum terjadi.

IOException

Operasi baca gagal. Periksa pengecualian dalam, jika ada, untuk menentukan penyebab kegagalan.

NotSupportedException

Sudah ada operasi baca yang sedang berlangsung.

ObjectDisposedException

Objek ini telah ditutup.

OperationCanceledException

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

Keterangan

Metode membaca maksimum count byte dari aliran dan menyimpannya di buffer awal di offset.

Anda tidak dapat melakukan beberapa operasi baca simultan.

Anda tidak dapat memanggil metode ini sampai Anda berhasil mengautentikasi.

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