SslStream.ReadAsync Methode

Definition

Namespace:

System.Net.Security

Assembly:

System.Net.Security.dll

Ü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

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

buffer

Memory<Byte>

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

cancellationToken

CancellationToken

Das Token zum Überwachen von Abbruchanforderungen.

Gibt zurück

ValueTask<Int32>

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

InvalidOperationException

Es ist keine Authentifizierung erfolgt.

IOException

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

NotSupportedException

Es wird bereits ein Lesevorgang ausgeführt.

ObjectDisposedException

Dieses Objekt wurde geschlossen.

OperationCanceledException

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.

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

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

Task<Int32>

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

ArgumentNullException

buffer ist null.

ArgumentOutOfRangeException

offset ist kleiner als 0.

- oder -

count ist kleiner als 0.

- oder -

count ist größer als die Länge von buffer minus offset.

InvalidOperationException

Es ist keine Authentifizierung erfolgt.

IOException

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

NotSupportedException

Es wird bereits ein Lesevorgang ausgeführt.

ObjectDisposedException

Dieses Objekt wurde geschlossen.

OperationCanceledException

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 in buffer ab 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 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. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Read(Byte[], Int32, Int32).