共用方式為


Stream.CopyTo 方法

定義

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

多載

CopyTo(Stream)

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

CopyTo(Stream, Int32)

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

CopyTo(Stream)

來源:
Stream.cs
來源:
Stream.cs
來源:
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

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

例外狀況

destinationnull

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

-或-

destination 不支援寫入。

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

發生 I/O 錯誤。

範例

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

// 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
來源:
Stream.cs
來源:
Stream.cs

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

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)

參數

destination
Stream

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

bufferSize
Int32

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

例外狀況

destinationnull

bufferSize 為負值或零。

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

-或-

destination 不支援寫入。

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

發生 I/O 錯誤。

備註

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

適用於