Stream.CopyTo Metoda

Definicja

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
Źródło:
Stream.cs
Ź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

destination to null.

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

-lub-

destination nie obsługuje pisania.

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

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.

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

CopyTo(Stream, Int32)

Źródło:
Stream.cs
Źródło:
Stream.cs
Ź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 void CopyTo (System.IO.Stream destination, int bufferSize);
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

destination to null.

bufferSize jest ujemna lub zero.

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

-lub-

destination nie obsługuje pisania.

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

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.

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0