Stream.CopyTo Stream.CopyTo Stream.CopyTo Stream.CopyTo Method

Definição

Lê os bytes do fluxo atual e os grava em outro fluxo.Reads the bytes from the current stream and writes them to another stream.

Sobrecargas

CopyTo(Stream) CopyTo(Stream) CopyTo(Stream) CopyTo(Stream)

Lê os bytes do fluxo atual e os grava em outro fluxo.Reads the bytes from the current stream and writes them to another stream.

CopyTo(Stream, Int32) CopyTo(Stream, Int32) CopyTo(Stream, Int32) CopyTo(Stream, Int32)

Lê os bytes do fluxo atual e os grava em outro fluxo usando um tamanho do buffer especificado.Reads the bytes from the current stream and writes them to another stream, using a specified buffer size.

CopyTo(Stream) CopyTo(Stream) CopyTo(Stream) CopyTo(Stream)

Lê os bytes do fluxo atual e os grava em outro fluxo.Reads the bytes from the current stream and writes them to another stream.

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 Stream Stream Stream

O fluxo para o qual o conteúdo do fluxo atual será copiado.The stream to which the contents of the current stream will be copied.

Exceções

Não há suporte para a leitura no fluxo atual.The current stream does not support reading.

- ou --or- destination não dá suporte à gravação.destination does not support writing.

O fluxo atual ou destination foram fechados antes do método CopyTo(Stream) ser chamado.Either the current stream or destination were closed before the CopyTo(Stream) method was called.

Ocorreu um erro de E/S.An I/O error occurred.

Exemplos

O exemplo a seguir copia o conteúdo de um FileStream para um MemoryStream.The following example copies the contents of a FileStream to a 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())

Comentários

A cópia começa na posição atual no fluxo atual e não redefine a posição do fluxo de destino depois que a operação de cópia for concluída.Copying begins at the current position in the current stream, and does not reset the position of the destination stream after the copy operation is complete.

CopyTo(Stream, Int32) CopyTo(Stream, Int32) CopyTo(Stream, Int32) CopyTo(Stream, Int32)

Lê os bytes do fluxo atual e os grava em outro fluxo usando um tamanho do buffer especificado.Reads the bytes from the current stream and writes them to another stream, using a specified buffer size.

public:
 void CopyTo(System::IO::Stream ^ destination, int bufferSize);
public void CopyTo (System.IO.Stream destination, int bufferSize);
member this.CopyTo : System.IO.Stream * int -> unit
Public Sub CopyTo (destination As Stream, bufferSize As Integer)

Parâmetros

destination
Stream Stream Stream Stream

O fluxo para o qual o conteúdo do fluxo atual será copiado.The stream to which the contents of the current stream will be copied.

bufferSize
Int32 Int32 Int32 Int32

O tamanho do buffer.The size of the buffer. Esse valor deve ser maior que zero.This value must be greater than zero. O tamanho padrão é 81920.The default size is 81920.

Exceções

Não há suporte para a leitura no fluxo atual.The current stream does not support reading.

- ou --or- destination não dá suporte à gravação.destination does not support writing.

O fluxo atual ou destination foram fechados antes do método CopyTo(Stream) ser chamado.Either the current stream or destination were closed before the CopyTo(Stream) method was called.

Ocorreu um erro de E/S.An I/O error occurred.

Comentários

A cópia começa na posição atual no fluxo atual e não redefine a posição do fluxo de destino depois que a operação de cópia for concluída.Copying begins at the current position in the current stream, and does not reset the position of the destination stream after the copy operation is complete.

Aplica-se a