Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

BufferedStream.ReadAsync-Methode: (Byte[], Int32, Int32, CancellationToken)

.NET Framework (current version)
 

Veröffentlicht: Oktober 2016

Liest eine Folge von Bytes asynchron aus dem aktuellen Stream, erhöht die Position im Stream um die Anzahl der gelesenen Bytes und überwacht Abbruchanfragen.

Namespace:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

public override Task<int> ReadAsync(
	byte[] buffer,
	int offset,
	int count,
	CancellationToken cancellationToken
)

Parameter

buffer
Type: System.Byte[]

Der Puffer, in den die Daten geschrieben werden sollen.

offset
Type: System.Int32

Der Byteoffset im buffer, ab dem Daten aus dem Stream geschrieben werden.

count
Type: System.Int32

Die maximale Anzahl der zu lesenden Bytes.

cancellationToken
Type: System.Threading.CancellationToken

Das Token zum überwachen von Abbruchanforderungen.

Rückgabewert

Type: System.Threading.Tasks.Task<Int32>

Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Der Wert des TResult-Parameters enthält die Gesamtzahl der Bytes, die in den Puffer gelesen werden. Der Ergebniswert kann niedriger als die Anzahl der angeforderten Bytes sein, wenn die Anzahl an derzeit verfügbaren Bytes kleiner ist als die angeforderte Anzahl, oder sie kann 0 (null) sein, wenn das Datenstromende erreicht ist.

Exception Condition
ArgumentNullException

buffer ist null.

ArgumentOutOfRangeException

offset oder count ist ein negativer Wert.

ArgumentException

Die Summe von offset und count ist größer als die Pufferlänge.

NotSupportedException

Lesevorgänge werden vom Stream nicht unterstützt.

ObjectDisposedException

Der Stream wurde verworfen.

InvalidOperationException

Der Stream wird zurzeit von einem vorherigen Lesevorgang verwendet.

You can create a cancellation token by creating an instance of the T:System.Threading.CancellationTokenSource class and passing the P:System.Threading.CancellationTokenSource.Token property as the cancellationToken parameter.

.NET Framework
Verfügbar seit 4.5
Zurück zum Anfang
Anzeigen: