(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

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

.NET Framework 4.5

Liest eine Folge von Bytes asynchron aus 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
Typ: System.Byte[]
Der Puffer, in den die Daten geschrieben werden sollen.
offset
Typ: System.Int32
Der Byteoffset im buffer, ab dem Daten aus dem Stream geschrieben werden.
count
Typ: System.Int32
Die maximale Anzahl der zu lesenden Bytes.
cancellationToken
Typ: System.Threading.CancellationToken
Das Token zum überwachen von Abbruchanforderungen .

Rückgabewert

Typ: 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.

AusnahmeBedingung
ArgumentNullException

buffer ist null.

ArgumentOutOfRangeException

offset oder count ist negativ.

ArgumentException

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

NotSupportedException

Lesevorgänge werden vom Stream nicht unterstützt.

ObjectDisposedException

Der Stream wurde freigegeben.

InvalidOperationException

Der Stream wird gerade durch einen früheren Lesevorgang.

Sie können ein Abbruchtoken erstellen, indem Sie eine Instanz der Klasse CancellationTokenSource erstellen und die Token-Eigenschaft als cancellationToken-Parameter übergeben.

.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft