Stream.CopyTo Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Legge i byte dal flusso corrente e li scrive in un altro flusso. Entrambe le posizioni dei flussi sono avanzate in base al numero di byte copiati.

Overload

CopyTo(Stream)	Legge i byte dal flusso corrente e li scrive in un altro flusso. Entrambe le posizioni dei flussi sono avanzate in base al numero di byte copiati.
CopyTo(Stream, Int32)	Legge tutti i byte dal flusso corrente e li scrive in un altro flusso, usando una dimensione di buffer specificata. Entrambe le posizioni dei flussi sono avanzate in base al numero di byte copiati.

CopyTo(Stream)

Origine:

Stream.cs

Legge i byte dal flusso corrente e li scrive in un altro flusso. Entrambe le posizioni dei flussi sono avanzate in base al numero di byte copiati.

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)

Parametri

destination

Stream

Flusso in cui verrà copiato il contenuto del flusso corrente.

Eccezioni

ArgumentNullException

destination è null.

NotSupportedException

Il flusso corrente non supporta la lettura.

-oppure-

destination non supporta la scrittura.

ObjectDisposedException

Il flusso corrente o destination sono stati chiusi prima che venisse chiamato il metodo CopyTo(Stream).

IOException

Si è verificato un errore di I/O.

Esempio

Nell'esempio seguente il contenuto di un FileStream oggetto viene copiato in un oggetto 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())

Commenti

La copia inizia nella posizione corrente nel flusso corrente e non reimposta la posizione del flusso di destinazione al termine dell'operazione di copia.

CopyTo(Stream, Int32)

Origine:

Stream.cs

Legge tutti i byte dal flusso corrente e li scrive in un altro flusso, usando una dimensione di buffer specificata. Entrambe le posizioni dei flussi sono avanzate in base al numero di byte copiati.

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)

Parametri

destination

Stream

Flusso in cui verrà copiato il contenuto del flusso corrente.

bufferSize

Int32

Dimensione del buffer. Il valore deve essere maggiore di zero. La dimensione predefinita è 81920.

Eccezioni

ArgumentNullException

destination è null.

ArgumentOutOfRangeException

bufferSize è un valore negativo o zero.

NotSupportedException

Il flusso corrente non supporta la lettura.

-oppure-

destination non supporta la scrittura.

ObjectDisposedException

Il flusso corrente o destination sono stati chiusi prima che venisse chiamato il metodo CopyTo(Stream).

IOException

Si è verificato un errore di I/O.

Commenti

La copia inizia nella posizione corrente nel flusso corrente e non reimposta la posizione del flusso di destinazione al termine dell'operazione di copia.