CopyToAsync Methode (Stream, Int32, CancellationToken)
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

Stream.CopyToAsync-Methode (Stream, Int32, CancellationToken)

.NET Framework (current version)
 

Liest die Bytes asynchron aus dem aktuellen Stream und schreibt sie unter Verwendung einer angegebenen Puffergröße und eines Abbruchtokens in einen anderen Stream.

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

[ComVisibleAttribute(false)]
[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)]
public virtual Task CopyToAsync(
	Stream destination,
	int bufferSize,
	CancellationToken cancellationToken
)

Parameter

destination

Der Stream, in den der Inhalt des aktuellen Stream kopiert wird.

bufferSize

Die Größe des Cookies in Bytes.Dieser Wert muss größer als 0 sein.Die Standardgröße ist 81920.

cancellationToken

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

Rückgabewert

Type: System.Threading.Tasks.Task

Eine Aufgabe, die den asynchronen Kopiervorgang darstellt.

Exception Condition
ArgumentNullException

destination ist null.

ArgumentOutOfRangeException

buffersize ist negativ oder 0 (null).

ObjectDisposedException

Entweder der aktuelle Stream oder der Zielstream wird freigegeben.

NotSupportedException

Der aktuelle Stream unterstützt kein Lesen oder Zielstream unterstützt keine Schreibvorgänge.

Die CopyToAsync -Methode können Sie ressourcenintensive e/a-Vorgänge durchführen, ohne dass der Hauptthread blockiert.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 Async-Methoden werden verwendet, in Verbindung mit der async und await in Visual Basic und C#-Schlüsselwörter.

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

Das Kopieren beginnt an der aktuellen Position im aktuellen Stream.

Ein Beispiel für das Kopieren zwischen zwei Datenströmen, finden Sie unter den CopyToAsync(Stream) überladen.

Universal Windows Platform
Verfügbar seit 4.5
.NET Framework
Verfügbar seit 4.5
Portable Class Library
Unterstützt in: portable .NET platforms
Windows Phone Silverlight
Verfügbar seit 8.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen:
© 2016 Microsoft