Stream.CopyTo Methode

Definition

Liest alle Bytes aus dem aktuellen Stream und schreibt sie in einen anderen Datenstrom.Reads the bytes from the current stream and writes them to another stream.

Überlädt

CopyTo(Stream)

Liest alle Bytes aus dem aktuellen Stream und schreibt sie in einen anderen Datenstrom.Reads the bytes from the current stream and writes them to another stream.

CopyTo(Stream, Int32)

Liest alles Bytes aus dem aktuellen Datenstrom und schreibt sie unter Verwendung einer angegebenen Puffergröße in einen anderen Datenstrom.Reads the bytes from the current stream and writes them to another stream, using a specified buffer size.

CopyTo(Stream)

Liest alle Bytes aus dem aktuellen Stream und schreibt sie in einen anderen Datenstrom.Reads the bytes from the current stream and writes them to another stream.

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.The stream to which the contents of the current stream will be copied.

Ausnahmen

destination ist null.destination is null.

Lesevorgänge werden vom aktuellen Stream nicht unterstützt.The current stream does not support reading.

- oder --or- destination unterstützt das Schreiben nicht.destination does not support writing.

Entweder der aktuelle Stream oder destination wurde geschlossen, bevor die CopyTo(Stream)-Methode aufgerufen wurde.Either the current stream or destination were closed before the CopyTo(Stream) method was called.

E/A-FehlerAn I/O error occurred.

Beispiele

Im folgenden Beispiel wird der Inhalt eines FileStream in einen MemoryStreamkopiert.The following example copies the contents of a FileStream to a MemoryStream.

// 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

Der Kopiervorgang beginnt an der aktuellen Position im aktuellen Stream und setzt die Position des zielstreams nicht zurück, nachdem der Kopiervorgang beendet wurde.Copying begins at the current position in the current stream, and does not reset the position of the destination stream after the copy operation is complete.

CopyTo(Stream, Int32)

Liest alles Bytes aus dem aktuellen Datenstrom und schreibt sie unter Verwendung einer angegebenen Puffergröße in einen anderen Datenstrom.Reads the bytes from the current stream and writes them to another stream, using a specified buffer size.

public:
 virtual void CopyTo(System::IO::Stream ^ destination, int bufferSize);
public virtual void CopyTo (System.IO.Stream destination, int bufferSize);
abstract member CopyTo : System.IO.Stream * int -> unit
override this.CopyTo : System.IO.Stream * int -> unit
Public Overridable Sub CopyTo (destination As Stream, bufferSize As Integer)

Parameter

destination
Stream

Der Stream, in den der Inhalt des aktuellen Stream kopiert wird.The stream to which the contents of the current stream will be copied.

bufferSize
Int32

Die Größe des Puffers.The size of the buffer. Dieser Wert muss größer als 0 sein.This value must be greater than zero. Die Standardgröße ist 81920.The default size is 81920.

Ausnahmen

destination ist null.destination is null.

bufferSize ist negativ oder 0 (null).bufferSize is negative or zero.

Lesevorgänge werden vom aktuellen Stream nicht unterstützt.The current stream does not support reading.

- oder --or- destination unterstützt das Schreiben nicht.destination does not support writing.

Entweder der aktuelle Stream oder destination wurde geschlossen, bevor die CopyTo(Stream)-Methode aufgerufen wurde.Either the current stream or destination were closed before the CopyTo(Stream) method was called.

E/A-FehlerAn I/O error occurred.

Hinweise

Der Kopiervorgang beginnt an der aktuellen Position im aktuellen Stream und setzt die Position des zielstreams nicht zurück, nachdem der Kopiervorgang beendet wurde.Copying begins at the current position in the current stream, and does not reset the position of the destination stream after the copy operation is complete.

Gilt für: