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. 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. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados.
CopyTo(Stream, Int32)	Lee los bytes de la secuencia actual y los escribe en otra secuencia mediante un 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. 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 a la que se copiará el contenido de la secuencia actual.

Excepciones

ArgumentNullException

destination es null.

NotSupportedException

La secuencia actual no admite la lectura.

-o-

destination no admite la escritura.

ObjectDisposedException

Se cerró la secuencia actual o destination antes de llamar al método CopyTo(Stream).

IOException

Error de E/S.

Ejemplos

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

CopyTo(Stream, Int32)

Source:

Stream.cs

Lee los bytes de la secuencia actual y los escribe en otra secuencia mediante un 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 a 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 negativo o cero.

NotSupportedException

La secuencia actual no admite la lectura.

-o-

destination no admite la escritura.

ObjectDisposedException

Se cerró la secuencia actual o destination 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.