Stream.CopyTo メソッド

定義

名前空間:: System.IO

アセンブリ:: mscorlib.dll, System.IO.dll

アセンブリ:: mscorlib.dll

アセンブリ:: System.IO.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

現在のストリームからバイトを読み取り、別のストリームに書き込みます。どちらのストリーム位置も、コピーされたバイト数だけ進みます。

オーバーロード

名前	説明
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

現在のストリームの内容のコピー先となるストリーム。

例外

ArgumentNullException

destination は nullです。

NotSupportedException

現在のストリームは読み取りをサポートしていません。

-または-

destination は書き込みをサポートしていません。

ObjectDisposedException

CopyTo(Stream) メソッドが呼び出される前に、現在のストリームまたはdestinationが閉じられました。

IOException

I/O エラーが発生しました。

例

次の例では、 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)

現在のストリームからバイトを読み取り、指定されたバッファーサイズを使用して別のストリームに書き込みます。どちらのストリーム位置も、コピーされたバイト数だけ進みます。

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)