Stream.CopyTo Método

Definición

Lee los bytes de la secuencia actual y los escribe en otra secuencia de destino. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados.

Sobrecargas

CopyTo(Stream)

Lee los bytes de la secuencia actual y los escribe en otra secuencia de destino. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados.

CopyTo(Stream, Int32)

Lee todos los bytes de la secuencia actual y los escribe en otra secuencia, usando el tamaño de búfer especificado. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados.

CopyTo(Stream)

Lee los bytes de la secuencia actual y los escribe en otra secuencia de destino. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados.

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)

Parámetros

destination
Stream

Secuencia en la que se copiará el contenido de la secuencia actual.

Excepciones

destination es null.

La secuencia actual no admite lectura.

o bien destination no admite la escritura.

La secuencia actual o destination se cerraron antes de llamar al método CopyTo(Stream).

Error de E/S.

Ejemplos

En el ejemplo siguiente se copia el contenido de en FileStream un objeto 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())

Comentarios

La copia comienza en la posición actual de la secuencia actual y no restablece la posición de la secuencia de destino una vez completada la operación de copia.

Se aplica a

CopyTo(Stream, Int32)

Lee todos los bytes de la secuencia actual y los escribe en otra secuencia, usando el tamaño de búfer especificado. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados.

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)

Parámetros

destination
Stream

Secuencia en la que se copiará el contenido de la secuencia actual.

bufferSize
Int32

Tamaño del búfer. Este valor debe ser mayor que cero. El tamaño predeterminado es 81920.

Excepciones

destination es null.

bufferSize es un valor negativo o es cero.

La secuencia actual no admite lectura.

o bien destination no admite la escritura.

La secuencia actual o destination se cerraron antes de llamar al método CopyTo(Stream).

Error de E/S.

Comentarios

La copia comienza en la posición actual de la secuencia actual y no restablece la posición de la secuencia de destino una vez completada la operación de copia.

Se aplica a