Stream.CopyTo Méthode

Définition

Lit les octets du flux actuel et les écrit dans un autre flux.

Surcharges

CopyTo(Stream)

Lit les octets du flux actuel et les écrit dans un autre flux.

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.

CopyTo(Stream)

Lit les octets du flux actuel et les écrit dans un autre flux.

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

destination a la valeur null.

Le flux actuel ne prend pas en charge la lecture.

  • ou - destination ne prend pas en charge l’écriture.

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

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 actuel et ne réinitialise pas la position du flux de destination une fois l’opération de copie terminée.

S’applique à

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.

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)

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

destination a la valeur null.

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

Le flux actuel ne prend pas en charge la lecture.

  • ou - destination ne prend pas en charge l’écriture.

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

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

Remarques

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

S’applique à