SslStream.ReadAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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
- 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).