(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
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

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

.NET Framework 4.5

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

Rückgabewert

Typ: System.Threading.Tasks.Task
Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.
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

Der Stream unterstützt das Schreiben nicht.

ObjectDisposedException

Der Stream wurde freigegeben.

InvalidOperationException

Der Stream wird derzeit von einem vorherigen Schreibvorgang verwendet.

Die WriteAsync-Methode ermöglicht es Ihnen, ressourcenintensive E/A-Vorgänge auszuführen, ohne den Hauptthread zu blockieren. Überlegung Diese zur Leistung ist in einer Windows Store-App oder Desktop-App besonders wichtig, in der ein zeitaufwendiger Streamvorgang den UI-Thread blockieren und die App angezeigt werden kann, als ob sie nicht funktioniert. Die asynchronen Methoden werden in Verbindung mit den Schlüsselwörtern async und await im Visual Basic und in C#.

Verwenden Sie die CanWrite-Eigenschaft, um zu bestimmen, ob die aktuelle Instanz Schreibvorgänge unterstützt.

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

Ein Beispiel finden Sie die Überladung WriteAsync(Byte[], Int32, Int32).

HinweisHinweis

Das HostProtectionAttribute -Attribut, das auf diesen Typ oder Member angewendet wird, besitzt den folgenden Resources Eigenschaftswert: ExternalThreading. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder einer URL in einem Browser gestartet werden). Weitere Informationen finden Sie unter HostProtectionAttribute -Klasse oder SQL Server-Programmierung und Hostschutzattribute.

.NET Framework

Unterstützt in: 4.5

.NET für Windows Store-Apps

Unterstützt in: Windows 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)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Vielen Dank für Ihr Feedback.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft. Alle Rechte vorbehalten.