Stream.CopyTo Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Odczytuje bajty z bieżącego strumienia i zapisuje je w innym strumieniu. Oba pozycje strumieni są zaawansowane przez liczbę skopiowanych bajtów.

Przeciążenia

CopyTo(Stream)	Odczytuje bajty z bieżącego strumienia i zapisuje je w innym strumieniu. Oba pozycje strumieni są zaawansowane przez liczbę skopiowanych bajtów.
CopyTo(Stream, Int32)	Odczytuje bajty z bieżącego strumienia i zapisuje je w innym strumieniu przy użyciu określonego rozmiaru buforu. Oba pozycje strumieni są zaawansowane przez liczbę skopiowanych bajtów.

CopyTo(Stream)

Źródło:

Stream.cs

Odczytuje bajty z bieżącego strumienia i zapisuje je w innym strumieniu. Oba pozycje strumieni są zaawansowane przez liczbę skopiowanych bajtów.

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

Strumień, do którego zostanie skopiowana zawartość bieżącego strumienia.

Wyjątki

ArgumentNullException

destination to null.

NotSupportedException

Bieżący strumień nie obsługuje odczytu.

-lub-

destination nie obsługuje pisania.

ObjectDisposedException

Bieżący strumień lub destination zostały zamknięte przed wywołaną CopyTo(Stream) metodą .

IOException

Wystąpił błąd we/wy.

Przykłady

Poniższy przykład kopiuje zawartość obiektu FileStream do obiektu 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())

Uwagi

Kopiowanie rozpoczyna się od bieżącego położenia w bieżącym strumieniu i nie resetuje położenia strumienia docelowego po zakończeniu operacji kopiowania.

CopyTo(Stream, Int32)

Źródło:

Stream.cs

Odczytuje bajty z bieżącego strumienia i zapisuje je w innym strumieniu przy użyciu określonego rozmiaru buforu. Oba pozycje strumieni są zaawansowane przez liczbę skopiowanych bajtów.

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

Strumień, do którego zostanie skopiowana zawartość bieżącego strumienia.

bufferSize

Int32

Rozmiar buforu. Ta wartość musi być większa niż zero. Domyślny rozmiar to 81920.

Wyjątki

ArgumentNullException

destination to null.

ArgumentOutOfRangeException

bufferSize jest ujemna lub zero.

NotSupportedException

Bieżący strumień nie obsługuje odczytu.

-lub-

destination nie obsługuje pisania.

ObjectDisposedException

Bieżący strumień lub destination zostały zamknięte przed wywołaną CopyTo(Stream) metodą .

IOException

Wystąpił błąd we/wy.

Uwagi

Kopiowanie rozpoczyna się od bieżącego położenia w bieżącym strumieniu i nie resetuje położenia strumienia docelowego po zakończeniu operacji kopiowania.