(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.CopyToAsync-Methode (Stream, Int32)

.NET Framework 4.5

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

Namespace:  System.IO
Assembly:  mscorlib (in mscorlib.dll)
[ComVisibleAttribute(false)]
[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)]
public Task CopyToAsync(
	Stream destination,
	int bufferSize
)

Parameter

destination
Typ: System.IO.Stream
Der Stream, in den der Inhalt des aktuellen Stream kopiert wird.
bufferSize
Typ: System.Int32
Die Größe des Cookies in Bytes. Dieser Wert muss größer als 0 sein. Die Standardgröße ist 4096.

Rückgabewert

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

Das Kopieren beginnt an der aktuellen Position im aktuellen Stream.

Ein Beispiel zum Kopieren zwischen zwei Streams, finden Sie die Überladung CopyToAsync(Stream).

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.