Stream.CopyTo Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Lit les octets du flux actuel et les écrit dans un autre flux. Les deux positions de flux sont avancées par le nombre d’octets copiés.

Surcharges

CopyTo(Stream)	Lit les octets du flux actuel et les écrit dans un autre flux. Les deux positions de flux sont avancées par le nombre d’octets copiés.
CopyTo(Stream, Int32)	Lit tous les octets du flux actuel et les écrit dans un autre flux, en utilisant une taille de mémoire tampon spécifiée. Les deux positions de flux sont avancées par le nombre d’octets copiés.

CopyTo(Stream)

Source:

Stream.cs

Lit les octets du flux actuel et les écrit dans un autre flux. Les deux positions de flux sont avancées par le nombre d’octets copiés.

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)

Paramètres

destination

Stream

Flux vers lequel le contenu du flux actuel sera copié.

Exceptions

ArgumentNullException

destination a la valeur null.

NotSupportedException

Le flux actuel ne prend pas en charge la lecture.

- ou -

destination ne prend pas en charge l’écriture.

ObjectDisposedException

Le flux actuel ou de destination a été fermé avant l’appel de la méthode CopyTo(Stream).

IOException

Une erreur d'E/S s'est produite.

Exemples

L’exemple suivant copie le contenu d’un FileStream dans 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())

Remarques

La copie commence à la position actuelle dans le flux actif et ne réinitialise pas la position du flux de destination une fois l’opération de copie terminée.

CopyTo(Stream, Int32)

Source:

Stream.cs

Lit tous les octets du flux actuel et les écrit dans un autre flux, en utilisant une taille de mémoire tampon spécifiée. Les deux positions de flux sont avancées par le nombre d’octets copiés.

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)

Paramètres

destination

Stream

Flux vers lequel le contenu du flux actuel sera copié.

bufferSize

Int32

Taille de la mémoire tampon. Cette valeur doit être supérieure à zéro. La taille par défaut est 81920.

Exceptions

ArgumentNullException

destination a la valeur null.

ArgumentOutOfRangeException

bufferSize est négatif ou égal à zéro.

NotSupportedException

Le flux actuel ne prend pas en charge la lecture.

- ou -

destination ne prend pas en charge l’écriture.

ObjectDisposedException

Le flux actuel ou de destination a été fermé avant l’appel de la méthode CopyTo(Stream).

IOException

Une erreur d'E/S s'est produite.

Remarques

La copie commence à la position actuelle dans le flux actif et ne réinitialise pas la position du flux de destination une fois l’opération de copie terminée.