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.

C#

public void CopyTo (System.IO.Stream destination);

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.

C#

// 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());

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.

C#

public virtual void CopyTo (System.IO.Stream destination, int bufferSize);

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.