Stream.CopyTo Método

Definição

Espaço de Nomes:: System.IO

Assemblagens:: mscorlib.dll, System.IO.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.IO.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Lê os bytes do fluxo atual e escreve-os noutro fluxo. As posições de ambos os fluxos são avançadas pelo número de bytes copiados.

Sobrecargas

Name	Description
CopyTo(Stream)	Lê os bytes do fluxo atual e escreve-os noutro fluxo. As posições de ambos os fluxos são avançadas pelo número de bytes copiados.
CopyTo(Stream, Int32)	Lê os bytes do fluxo atual e escreve-os noutro fluxo, usando um tamanho de buffer especificado. As posições de ambos os fluxos são avançadas pelo número de bytes copiados.

CopyTo(Stream)

Lê os bytes do fluxo atual e escreve-os noutro fluxo. As posições de ambos os fluxos são avançadas pelo 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

O fluxo para o qual o conteúdo do fluxo atual será copiado.

Exceções

ArgumentNullException

destination é null.

NotSupportedException

O fluxo atual não suporta leitura.

-ou-

destination não suporta a escrita.

ObjectDisposedException

Ou o fluxo atual ou destination estavam fechados antes de o CopyTo(Stream) método ser chamado.

IOException

Ocorreu um erro de I/O.

Exemplos

O exemplo seguinte copia o conteúdo de a FileStream para um 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())

Observações

A cópia começa na posição atual no fluxo atual e não reinicia a posição do fluxo de destino após a conclusão da operação de cópia.

Aplica-se a

CopyTo(Stream, Int32)

Lê os bytes do fluxo atual e escreve-os noutro fluxo, usando um tamanho de buffer especificado. As posições de ambos os fluxos são avançadas pelo 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)