NegotiateStream.ReadAsync Methode

Definition

Namespace:

System.Net.Security

Assembly:

System.Net.Security.dll

Überlädt

ReadAsync(Memory<Byte>, CancellationToken)	Liest Daten asynchron aus dem NegotiateStream und speichert sie als asynchronen Vorgang in einem Bytespeicherbereich.
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Liest Daten asynchron aus diesem Stream und speichert sie im angegebenen Array.

ReadAsync(Memory<Byte>, CancellationToken)

Quelle:

NegotiateStream.cs

Liest Daten asynchron aus dem NegotiateStream und speichert sie als asynchronen Vorgang in einem Bytespeicherbereich.

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>

Der Puffer, in den die Daten geschrieben werden sollen.

cancellationToken

CancellationToken

Das Token zum Überwachen von Abbruchanforderungen.

Gibt zurück

ValueTask<Int32>

Eine ValueTask<TResult>, die den asynchronen Lesevorgang darstellt. Der Wert seiner Result-Eigenschaft enthält die Gesamtzahl der Bytes, die in buffer gelesen werden.

Ausnahmen

IOException

Fehler beim Lesevorgang.

InvalidOperationException

Es ist keine Authentifizierung erfolgt.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode liest asynchron so viele Daten ein, wie verfügbar sind, buffer und gibt die Anzahl der erfolgreich gelesenen Bytes zurück.

Sie können diese Methode erst aufrufen, wenn Sie sich erfolgreich authentifiziert haben. Rufen Sie zum Authentifizieren eine der AuthenticateAsClientMethoden , AuthenticateAsClientAsync, BeginAuthenticateAsClient, AuthenticateAsServer, oder BeginAuthenticateAsServerAuthenticateAsServerAsyncauf.

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

Quelle:

NegotiateStream.cs

Liest Daten asynchron aus diesem Stream und speichert sie im angegebenen Array.

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[]

Ein Byte-Array, das die Bytes empfängt, die aus dem Stream gelesen werden.

offset

Int32

Ein Int32, der den nullbasierten Speicherort im buffer enthält, ab dem die aus diesem Stream gelesenen Daten gespeichert werden.

count

Int32

Ein Int32, der die maximale Anzahl der aus dem Stream gelesenen Bytes enthält.

cancellationToken

CancellationToken

Das Token zum Überwachen von Abbruchanforderungen.

Gibt zurück

Task<Int32>

Ein Int32-Wert, der die Anzahl von Bytes angibt, die aus dem zugrunde liegenden Datenstrom gelesen werden. Gibt 0 (null) zurück, wenn keine weiteren zu lesenden Daten vorhanden sind.

Ausnahmen

IOException

Fehler beim Lesevorgang.

InvalidOperationException

Es ist keine Authentifizierung erfolgt.

NotSupportedException

Es wird gerade ein Read(Byte[], Int32, Int32)-Vorgang ausgeführt.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Die -Methode liest asynchron ein Maximum an count Bytes aus dem aktuellen Stream und speichert sie am buffer Anfang unter offset.

Sie können diese Methode erst aufrufen, wenn Sie sich erfolgreich authentifiziert haben. Rufen Sie zum Authentifizieren eine der AuthenticateAsClientMethoden , AuthenticateAsClientAsync, BeginAuthenticateAsClient, AuthenticateAsServer, oder BeginAuthenticateAsServerAuthenticateAsServerAsyncauf.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Read(Byte[], Int32, Int32)Ausnahmen.