Stream.CopyTo 方法

定義

從目前資料流讀取位元組,並將其寫入另一個資料流中。

多載

CopyTo(Stream)

從目前資料流讀取位元組,並將其寫入另一個資料流中。

CopyTo(Stream, Int32)

使用指定的緩衝區大小,從目前資料流讀取所有位元組,並將其寫入另一個資料流中。

CopyTo(Stream)

從目前資料流讀取位元組,並將其寫入另一個資料流中。

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)

使用指定的緩衝區大小,從目前資料流讀取所有位元組,並將其寫入另一個資料流中。

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 錯誤。

備註

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

適用於