MemoryStream.CopyToAsync(Stream, Int32, CancellationToken) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Liest asynchron alle Bytes aus dem aktuellen Datenstrom und schreibt sie mithilfe eines angegebenen Puffergrößen- und Abbruchtokens in einen anderen Datenstrom.
public:
override System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ destination, int bufferSize, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task CopyToAsync(System.IO.Stream destination, int bufferSize, System.Threading.CancellationToken cancellationToken);
override this.CopyToAsync : System.IO.Stream * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function CopyToAsync (destination As Stream, bufferSize As Integer, cancellationToken As CancellationToken) As Task
Parameter
- destination
- Stream
Der Stream, in den der Inhalt des aktuellen Datenstroms kopiert wird.
- bufferSize
- Int32
Die Größe des Puffers in Bytes. Dieser Wert muss größer als Null sein.
- cancellationToken
- CancellationToken
Das Token, das auf Abbruchanforderungen überwacht werden soll.
Gibt zurück
Eine Aufgabe, die den asynchronen Kopiervorgang darstellt.
Ausnahmen
destination ist null.
bufferSize ist negativ oder null.
Entweder der aktuelle Datenstrom oder der Zieldatenstrom wird verworfen.
Der aktuelle Datenstrom unterstützt das Lesen nicht, oder der Zieldatenstrom unterstützt das Schreiben nicht.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von CopyTo(Stream, Int32).