Stream.CopyTo Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přečte bajty z aktuálního datového proudu a zapíše je do jiného datového proudu. Obě pozice datových proudů se posouvají podle počtu zkopírovaných bajtů.

Přetížení

CopyTo(Stream)	Přečte bajty z aktuálního datového proudu a zapíše je do jiného datového proudu. Obě pozice datových proudů se posouvají podle počtu zkopírovaných bajtů.
CopyTo(Stream, Int32)	Načte bajty z aktuálního datového proudu a zapíše je do jiného datového proudu s použitím zadané velikosti vyrovnávací paměti. Obě pozice datových proudů se posouvají podle počtu zkopírovaných bajtů.

CopyTo(Stream)

Zdroj:

Stream.cs

Přečte bajty z aktuálního datového proudu a zapíše je do jiného datového proudu. Obě pozice datových proudů se posouvají podle počtu zkopírovaných bajtů.

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)

Parametry

destination

Stream

Datový proud, do kterého se zkopíruje obsah aktuálního datového proudu.

Výjimky

ArgumentNullException

destination je null.

NotSupportedException

Aktuální datový proud nepodporuje čtení.

-nebo-

destination nepodporuje psaní.

ObjectDisposedException

Buď aktuální datový proud, nebo destination byly uzavřeny před zavolání CopyTo(Stream) metody.

IOException

Došlo k vstupně-výstupní chybě.

Příklady

Následující příklad zkopíruje obsah objektu FileStream do objektu 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())

Poznámky

Kopírování začíná na aktuální pozici v aktuálním datovém proudu a po dokončení operace kopírování neobnoví pozici cílového datového proudu.

CopyTo(Stream, Int32)

Zdroj:

Stream.cs

Načte bajty z aktuálního datového proudu a zapíše je do jiného datového proudu s použitím zadané velikosti vyrovnávací paměti. Obě pozice datových proudů se posouvají podle počtu zkopírovaných bajtů.

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)

Parametry

destination

Stream

Datový proud, do kterého se zkopíruje obsah aktuálního datového proudu.

bufferSize

Int32

Velikost vyrovnávací paměti. Tato hodnota musí být větší než nula. Výchozí velikost je 81920.

Výjimky

ArgumentNullException

destination je null.

ArgumentOutOfRangeException

bufferSize je záporná nebo nulová.

NotSupportedException

Aktuální datový proud nepodporuje čtení.

-nebo-

destination nepodporuje psaní.

ObjectDisposedException

Buď aktuální datový proud, nebo destination byly uzavřeny před zavolání CopyTo(Stream) metody.

IOException

Došlo k vstupně-výstupní chybě.

Poznámky

Kopírování začíná na aktuální pozici v aktuálním datovém proudu a po dokončení operace kopírování neobnoví pozici cílového datového proudu.