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.

C#

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

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.

C#

// 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());

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.

C#

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

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.