NegotiateStream.ReadAsync Metode

Definisi

Ruang nama:

System.Net.Security

Rakitan:

System.Net.Security.dll

Overload

ReadAsync(Memory<Byte>, CancellationToken)	Membaca data secara asinkron dari NegotiateStream dan menyimpannya dalam rentang memori byte sebagai operasi asinkron.
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Membaca data secara asinkron dari aliran ini dan menyimpannya dalam array yang ditentukan.

ReadAsync(Memory<Byte>, CancellationToken)

Sumber:

NegotiateStream.cs

Membaca data secara asinkron dari NegotiateStream 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

IOException

Operasi baca gagal.

InvalidOperationException

Autentikasi belum terjadi.

OperationCanceledException

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

Keterangan

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

Anda tidak dapat memanggil metode ini sampai Anda berhasil mengautentikasi. Untuk mengautentikasi, panggil salah AuthenticateAsClientsatu metode , , AuthenticateAsClientAsyncBeginAuthenticateAsClient, AuthenticateAsServer, AuthenticateAsServerAsyncatau BeginAuthenticateAsServer .

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

Sumber:

NegotiateStream.cs

Membaca data secara asinkron dari aliran ini dan menyimpannya dalam array 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[]

Array Byte yang menerima byte yang dibaca dari aliran.

offset

Int32

yang Int32 berisi lokasi berbasis nol untuk buffer mulai menyimpan data yang dibaca dari aliran ini.

count

Int32

yang Int32 berisi jumlah maksimum byte untuk dibaca dari aliran.

cancellationToken

CancellationToken

Token yang akan dipantau untuk permintaan pembatalan.

Mengembalikan

Task<Int32>

Nilai Int32 yang menentukan jumlah byte yang dibaca dari aliran yang mendasar. Ketika tidak ada lagi data yang akan dibaca, mengembalikan 0.

Pengecualian

IOException

Operasi baca gagal.

InvalidOperationException

Autentikasi belum terjadi.

NotSupportedException

Operasi Read(Byte[], Int32, Int32) sudah berlangsung.

OperationCanceledException

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

Keterangan

Metode membaca secara asinkron maksimum count byte dari aliran saat ini dan menyimpannya di buffer awal di offset.

Anda tidak dapat memanggil metode ini sampai Anda berhasil mengautentikasi. Untuk mengautentikasi, panggil salah AuthenticateAsClientsatu metode , , AuthenticateAsClientAsyncBeginAuthenticateAsClient, AuthenticateAsServer, AuthenticateAsServerAsyncatau BeginAuthenticateAsServer .

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