Stream.CopyTo Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.IO
Zestaw:
System.IO.dll
Zestaw:
System.Runtime.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.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)

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.

Dotyczy

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.

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

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.

Dotyczy