Stream.CopyTo Metoda

  • Reference

Definice

Obor názvů:
System.IO
Sestavení:
System.IO.dll
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.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)

Přečte bajty z aktuálního datového proudu a zapíše je do jiného datového proudu pomocí 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
Zdroj:
Stream.cs
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í neobsadí pozici cílového datového proudu.

Platí pro

CopyTo(Stream, Int32)

Zdroj:
Stream.cs
Zdroj:
Stream.cs
Zdroj:
Stream.cs

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

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)

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í neobsadí pozici cílového datového proudu.

Platí pro