Stream.CopyTo Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

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)

Source:

Stream.cs

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

ArgumentNullException

destination es null.

NotSupportedException

La secuencia actual no admite lectura.

o bien

destination no admite la escritura.

ObjectDisposedException

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

IOException

Error de E/S.

Ejemplos

En el ejemplo siguiente se copia el contenido de en FileStream un MemoryStreamobjeto .

// 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.

CopyTo(Stream, Int32)

Source:

Stream.cs

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:
 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)

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

ArgumentNullException

destination es null.

ArgumentOutOfRangeException

bufferSize es un valor negativo o es cero.

NotSupportedException

La secuencia actual no admite lectura.

o bien

destination no admite la escritura.

ObjectDisposedException

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

IOException

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.