SslStream.ReadAsync Methode

Definition

Überlädt

Name Beschreibung
ReadAsync(Memory<Byte>, CancellationToken)

Liest asynchron Daten aus diesem Datenstrom und speichert sie im angegebenen Speicherbereich.

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

Liest Daten asynchron aus diesem Datenstrom und speichert sie im angegebenen Bereich eines Bytearrays.

ReadAsync(Memory<Byte>, CancellationToken)

Liest asynchron Daten aus diesem Datenstrom und speichert sie im angegebenen Speicherbereich.

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, der die aus diesem Datenstrom gelesenen Bytes empfängt.

cancellationToken
CancellationToken

Das Token, das auf Abbruchanforderungen überwacht werden soll.

Gibt zurück

Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Der Wert seiner Result Eigenschaft enthält die Gesamtanzahl der in .buffer Wenn keine weiteren Zu lesenden Daten vorhanden sind, wird 0 zurückgegeben.

Ausnahmen

Die Authentifizierung ist nicht aufgetreten.

Fehler beim Lesevorgang. Überprüfen Sie die innere Ausnahme, falls vorhanden, um die Ursache des Fehlers zu ermitteln.

Es wird bereits ein Lesevorgang ausgeführt.

Dieses Objekt wurde geschlossen.

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

Hinweise

Diese Methode liest so viele Daten wie in der buffer.

Sie können nicht mehrere gleichzeitige Lesevorgänge ausführen.

Sie können diese Methode erst aufrufen, nachdem Sie sich erfolgreich authentifiziert haben.

Gilt für:

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

Liest Daten asynchron aus diesem Datenstrom und speichert sie im angegebenen Bereich eines Bytearrays.

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

Der Puffer, der die aus diesem Datenstrom gelesenen Bytes empfängt.

offset
Int32

Der nullbasierte Speicherort, an buffer dem die Auslesedaten aus diesem Datenstrom gespeichert werden sollen.

count
Int32

Die maximale Anzahl von Bytes, die aus diesem Datenstrom gelesen werden sollen.

cancellationToken
CancellationToken

Das Token, das auf Abbruchanforderungen überwacht werden soll.

Gibt zurück

Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Der Wert seiner Result Eigenschaft enthält die Gesamtanzahl der in .buffer Wenn keine weiteren Zu lesenden Daten vorhanden sind, wird 0 zurückgegeben.

Ausnahmen

buffer ist null.

offset ist kleiner als 0.

-oder-

count ist kleiner als 0.

-oder-

count ist größer als die Länge des Minuszeichens bufferoffset.

Die Authentifizierung ist nicht aufgetreten.

Fehler beim Lesevorgang. Überprüfen Sie die innere Ausnahme, falls vorhanden, um die Ursache des Fehlers zu ermitteln.

Es wird bereits ein Lesevorgang ausgeführt.

Dieses Objekt wurde geschlossen.

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

Hinweise

Die Methode liest maximal count Bytes aus dem Datenstrom und speichert sie beginnend buffer bei offset.

Sie können nicht mehrere gleichzeitige Lesevorgänge ausführen.

Sie können diese Methode erst aufrufen, nachdem Sie sich erfolgreich authentifiziert haben.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Read(Byte[], Int32, Int32).

Gilt für: