Stream.CopyTo Methode

Referenz

Definition

Namespace:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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 alle Bytes aus dem aktuellen Stream und schreibt sie in einen anderen Datenstrom. Beide Datenstrompositionen werden um die Anzahl der kopierten Bytes erweitert.

Überlädt

CopyTo(Stream)	Liest alle Bytes aus dem aktuellen Stream und schreibt sie in einen anderen Datenstrom. Beide Datenstrompositionen werden um die Anzahl der kopierten Bytes erweitert.
CopyTo(Stream, Int32)	Liest alles Bytes aus dem aktuellen Datenstrom und schreibt sie unter Verwendung einer angegebenen Puffergröße in einen anderen Datenstrom. Beide Datenstrompositionen werden um die Anzahl der kopierten Bytes erweitert.

CopyTo(Stream)

Quelle:: Stream.cs

Quelle:: Stream.cs

Quelle:: Stream.cs

Liest alle Bytes aus dem aktuellen Stream und schreibt sie in einen anderen Datenstrom. Beide Datenstrompositionen werden um die Anzahl der kopierten Bytes erweitert.

public:
 void CopyTo(System::IO::Stream ^ destination);

public void CopyTo (System.IO.Stream destination);

member this.CopyTo : System.IO.Stream -> unit

Public Sub CopyTo (destination As Stream)

Parameter

destination: Stream

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

Ausnahmen

ArgumentNullException

destination ist null.

NotSupportedException

Lesevorgänge werden vom aktuellen Stream nicht unterstützt.

- oder -

destination unterstützt das Schreiben nicht.

ObjectDisposedException

Entweder der aktuelle Stream oder destination wurde geschlossen, bevor die CopyTo(Stream)-Methode aufgerufen wurde.

IOException

E/A-Fehler

Beispiele

Im folgenden Beispiel wird der Inhalt von FileStream in eine MemoryStreamkopiert.

// Create the streams.
MemoryStream destination = new MemoryStream();

using (FileStream source = File.Open(@"c:\temp\data.dat",
    FileMode.Open))
{

    Console.WriteLine("Source length: {0}", source.Length.ToString());

    // Copy source to destination.
    source.CopyTo(destination);
}

Console.WriteLine("Destination length: {0}", destination.Length.ToString());

' Create the streams.
Dim destination As New MemoryStream()

Using source As FileStream = File.Open("c:\temp\data.dat", _
                                       FileMode.Open)
    Console.WriteLine("Source length: {0}", source.Length.ToString())

    ' Copy source to destination.
    source.CopyTo(destination)

End Using
Console.WriteLine("Destination length: {0}", destination.Length.ToString())

Hinweise

Das Kopieren beginnt an der aktuellen Position im aktuellen Stream und setzt die Position des Zieldatenstroms nicht zurück, nachdem der Kopiervorgang abgeschlossen ist.

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

CopyTo(Stream, Int32)

Quelle:: Stream.cs

Quelle:: Stream.cs

Quelle:: Stream.cs

Liest alles Bytes aus dem aktuellen Datenstrom und schreibt sie unter Verwendung einer angegebenen Puffergröße in einen anderen Datenstrom. Beide Datenstrompositionen werden um die Anzahl der kopierten Bytes erweitert.

public:
 void CopyTo(System::IO::Stream ^ destination, int bufferSize);

public:
 virtual void CopyTo(System::IO::Stream ^ destination, int bufferSize);

public void CopyTo (System.IO.Stream destination, int bufferSize);

public virtual void CopyTo (System.IO.Stream destination, int bufferSize);

member this.CopyTo : System.IO.Stream * int -> unit

abstract member CopyTo : System.IO.Stream * int -> unit
override this.CopyTo : System.IO.Stream * int -> unit

Public Sub CopyTo (destination As Stream, bufferSize As Integer)

Public Overridable Sub CopyTo (destination As Stream, bufferSize As Integer)

Parameter

destination: Stream

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

bufferSize: Int32

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

Ausnahmen

ArgumentNullException

destination ist null.

ArgumentOutOfRangeException

bufferSize ist negativ oder 0 (null).

NotSupportedException

Lesevorgänge werden vom aktuellen Stream nicht unterstützt.

- oder -

destination unterstützt das Schreiben nicht.

ObjectDisposedException

Entweder der aktuelle Stream oder destination wurde geschlossen, bevor die CopyTo(Stream)-Methode aufgerufen wurde.

IOException

E/A-Fehler

Hinweise

Das Kopieren beginnt an der aktuellen Position im aktuellen Stream und setzt die Position des Zieldatenstroms nicht zurück, nachdem der Kopiervorgang abgeschlossen ist.

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Freigeben über

Stream.CopyTo Methode

Definition

Überlädt

CopyTo(Stream)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

CopyTo(Stream, Int32)

Parameter

Ausnahmen

Hinweise

Gilt für:

Zusätzliche Ressourcen