Stream.CopyTo Метод

Определение

Пространство имен:

System.IO

Сборка:

System.Runtime.dll

Считывает байты из текущего потока и записывает их в другой поток. Обе позиции потоков перемещаются по количеству скопированных байтов.

Перегрузки

CopyTo(Stream)	Считывает байты из текущего потока и записывает их в другой поток. Обе позиции потоков перемещаются по количеству скопированных байтов.
CopyTo(Stream, Int32)	Считывает байты из текущего потока и записывает их в другой поток, используя указанный размер буфера. Обе позиции потоков перемещаются по количеству скопированных байтов.

CopyTo(Stream)

Исходный код:

Stream.cs

Считывает байты из текущего потока и записывает их в другой поток. Обе позиции потоков перемещаются по количеству скопированных байтов.

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)

Параметры

destination

Stream

Поток, в который будет скопировано содержимое текущего потока.

Исключения

ArgumentNullException

destination имеет значение null.

NotSupportedException

Текущий поток не поддерживает чтение.

-или-

Параметр destination не поддерживает запись.

ObjectDisposedException

Текущий поток или параметр destination был закрыт до вызова метода CopyTo(Stream).

IOException

Ошибка ввода/вывода.

Примеры

В следующем примере содержимое FileStream копируется в 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())

Комментарии

Копирование начинается с текущей позиции в текущем потоке и не сбрасывает положение целевого потока после завершения операции копирования.

CopyTo(Stream, Int32)

Исходный код:

Stream.cs

Считывает байты из текущего потока и записывает их в другой поток, используя указанный размер буфера. Обе позиции потоков перемещаются по количеству скопированных байтов.

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)

Параметры

destination

Stream

Поток, в который будет скопировано содержимое текущего потока.

bufferSize

Int32

Размер буфера. Это значение должно быть больше нуля. Размер по умолчанию — 81920.

Исключения

ArgumentNullException

destination имеет значение null.

ArgumentOutOfRangeException

Параметр bufferSize имеет отрицательное значение или равен нулю.

NotSupportedException

Текущий поток не поддерживает чтение.

-или-

Параметр destination не поддерживает запись.

ObjectDisposedException

Текущий поток или параметр destination был закрыт до вызова метода CopyTo(Stream).

IOException

Ошибка ввода/вывода.

Комментарии

Копирование начинается с текущей позиции в текущем потоке и не сбрасывает положение целевого потока после завершения операции копирования.