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
| ReadAsync(Memory<Byte>, CancellationToken) |
Liest Daten asynchron 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)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
Liest Daten asynchron 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 zum Überwachen von Abbruchanforderungen.
Gibt zurück
Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Der Wert seiner Result-Eigenschaft enthält die Gesamtzahl der Bytes, die in buffer gelesen werden. Gibt 0 (null) zurück, wenn keine weiteren zu lesenden Daten vorhanden sind.
Ausnahmen
Es ist keine Authentifizierung erfolgt.
Fehler beim Lesevorgang. Überprüfen Sie, sofern vorhanden, die innere Ausnahme, 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 bufferverfügbar sind.
Sie können nicht mehrere gleichzeitige Lesevorgänge ausführen.
Sie können diese Methode erst aufrufen, wenn Sie sich erfolgreich authentifiziert haben.
Gilt für:
ReadAsync(Byte[], Int32, Int32, CancellationToken)
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
- Quelle:
- SslStream.cs
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 Bytes empfängt, die aus diesem Datenstrom gelesen werden.
- offset
- Int32
Der nullbasierte Speicherort im buffer, ab dem die aus diesem Stream gelesenen Daten gespeichert werden.
- count
- Int32
Die maximale Anzahl an Bytes, die aus diesem Datenstrom gelesen werden sollen.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen.
Gibt zurück
Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Der Wert seiner Result-Eigenschaft enthält die Gesamtzahl der Bytes, die in buffer gelesen werden. Gibt 0 (null) zurück, wenn keine weiteren zu lesenden Daten vorhanden sind.
Ausnahmen
buffer ist null.
offset ist kleiner als 0.
- oder -
count ist kleiner als 0.
- oder -
count ist größer als die Länge von buffer minus offset.
Es ist keine Authentifizierung erfolgt.
Fehler beim Lesevorgang. Überprüfen Sie, sofern vorhanden, die innere Ausnahme, 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 Stream und speichert sie am buffer Anfang unter offset.
Sie können nicht mehrere gleichzeitige Lesevorgänge ausführen.
Sie können diese Methode erst aufrufen, wenn Sie sich erfolgreich authentifiziert haben.
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.
