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

Stream.WriteAsync-Methode: (Byte[], Int32, Int32, CancellationToken)

.NET Framework (current version)
 

Veröffentlicht: Oktober 2016

Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Folge von Bytes asynchron in den aktuellen Stream und erhöht die aktuelle Position im Stream um die Anzahl der geschriebenen Bytes und überwacht Abbruchanforderungen.

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

[ComVisibleAttribute(false)]
[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)]
public virtual Task WriteAsync(
	byte[] buffer,
	int offset,
	int count,
	CancellationToken cancellationToken
)

Parameter

buffer
Type: System.Byte[]

Der Puffer, aus dem Daten geschrieben werden sollen.

offset
Type: System.Int32

Der nullbasierte Byteoffset im buffer, ab dem Bytes in den Stream kopiert werden.

count
Type: System.Int32

Die maximale Anzahl der zu schreibenden Bytes.

cancellationToken
Type: System.Threading.CancellationToken

Das Token zum überwachen von Abbruchanforderungen . Der Standardwert ist None.

Rückgabewert

Type: System.Threading.Tasks.Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

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

Der Stream unterstützt das Schreiben nicht.

ObjectDisposedException

Der Stream wurde verworfen.

InvalidOperationException

Der Stream wird zurzeit von einem vorherigen Schreibvorgang verwendet.

Die WriteAsync -Methode können Sie ressourcenintensive e/a-Vorgänge ausführen, ohne den Hauptthread zu blockieren. Diese Überlegungen zur Leistung sind insbesondere in einer Windows 8.x Store-App oder Desktop-App wichtig, bei der ein zeitaufwendiger Streamvorgang den UI-Thread blockieren kann und es dann den Anschein hat, dass Ihre App nicht funktioniert. Die asynchronen Methoden wird in Verbindung mit der async und await in Visual Basic und C#-Schlüsselwörter.

Verwenden der CanWrite -Eigenschaft bestimmt, ob die aktuelle Instanz Schreibvorgänge unterstützt.

Wenn der Vorgang abgebrochen wird, bevor er abgeschlossen ist, enthält die zurückgegebene Aufgabe der Canceled -Wert für die Status Eigenschaft.

Ein Beispiel finden Sie unter der WriteAsync(Byte[], Int32, Int32) überladen.

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 4.5
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Windows Phone Silverlight
Verfügbar seit 8.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: