Stream.CopyTo 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

從目前資料流讀取位元組，並將其寫入另一個資料流中。 這兩個數據流位置都是由複製的位元元組數目進階。

多載

CopyTo(Stream)	從目前資料流讀取位元組，並將其寫入另一個資料流中。 這兩個數據流位置都是由複製的位元元組數目進階。
CopyTo(Stream, Int32)	使用指定的緩衝區大小，從目前資料流讀取所有位元組，並將其寫入另一個資料流中。 這兩個數據流位置都是由複製的位元元組數目進階。

CopyTo(Stream)

來源:

Stream.cs

從目前資料流讀取位元組，並將其寫入另一個資料流中。 這兩個數據流位置都是由複製的位元元組數目進階。

C#

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

參數

destination

Stream

目前資料流的內容將複製到其中的資料流。

例外狀況

ArgumentNullException

destination 為 null。

NotSupportedException

目前的資料流不支援讀取。

-或-

destination 不支援寫入。

ObjectDisposedException

目前資料流或 destination 已經在呼叫 CopyTo(Stream) 方法之前關閉。

IOException

發生 I/O 錯誤。

範例

下列範例會將 的內容FileStreamMemoryStream複製到 。

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

備註

複製會從目前數據流的目前位置開始，而且不會在複製作業完成之後重設目的地數據流的位置。

CopyTo(Stream, Int32)

來源:

Stream.cs

使用指定的緩衝區大小，從目前資料流讀取所有位元組，並將其寫入另一個資料流中。 這兩個數據流位置都是由複製的位元元組數目進階。

C#

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

參數

destination

Stream

目前資料流的內容將複製到其中的資料流。

bufferSize

Int32

緩衝區的大小。 這個值必須大於零。 預設大小為 81920。

例外狀況

ArgumentNullException

destination 為 null。

ArgumentOutOfRangeException

bufferSize 為負值或零。

NotSupportedException

目前的資料流不支援讀取。

-或-

destination 不支援寫入。

ObjectDisposedException

目前資料流或 destination 已經在呼叫 CopyTo(Stream) 方法之前關閉。

IOException

發生 I/O 錯誤。

備註

複製會從目前數據流的目前位置開始，而且不會在複製作業完成之後重設目的地數據流的位置。