Stream.Write メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Stream.Write メソッド

派生クラスによってオーバーライドされた場合は、現在のストリームにバイトシーケンスを書き込み、書き込んだバイト数の分だけストリームの現在位置を進めます。

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Sub
 Write ( _
    buffer As Byte(), _
    offset As Integer, _
    count As Integer _
)

Visual Basic (使用法)

Dim instance As Stream
Dim buffer As Byte()
Dim offset As Integer
Dim count As Integer

instance.Write(buffer, offset, count)

public abstract void Write (
    byte[] buffer,
    int offset,
    int count
)

C++

public:
virtual void Write (
    array<unsigned char>^ buffer, 
    int offset, 
    int count
) abstract

public abstract void Write (
    byte[] buffer, 
    int offset, 
    int count
)

JScript

public abstract function Write (
    buffer : byte[], 
    offset : int, 
    count : int
)

パラメータ

buffer: バイト配列。このメソッドは、buffer から現在のストリームに、count で指定されたバイト数だけコピーします。

offset: 現在のストリームへのバイトのコピーを開始する位置を示す buffer 内のバイトオフセット。インデックス番号は 0 から始まります。

count: 現在のストリームに書き込むバイト数。

例外

例外の種類	条件
ArgumentException	offset と count の合計値が、バッファ長より大きい値です。
ArgumentNullException	buffer が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	offset または count が負の値です。
IOException	I/O エラーが発生しました。
NotSupportedException	ストリームが書き込みをサポートしません。
ObjectDisposedException	ストリームが閉じられた後でメソッドが呼び出されました。

解説

ファイルの作成およびテキストのファイルへの書き込みの例については、「方法 : ファイルにテキストを書き込む」を参照してください。ファイルからのテキストの読み取りの例については、「方法 : ファイルからテキストを読み取る」を参照してください。バイナリファイルの読み取りおよび書き込みの例については、「方法 : 新しく作成されたデータファイルに対して読み書きする」を参照してください。

現在のインスタンスが書き込みをサポートしているかどうかを判断するには、CanWrite プロパティを使用します。

書き込み操作が成功した場合は、書き込まれたバイト数だけストリーム内の位置が進みます。例外が発生した場合は、ストリーム内の位置はそのまま変わりません。

既定の実装は、非同期の BeginWrite メソッドを呼び出します。

使用例

Write メソッドを使用して、入力ストリームを出力ストリームにコピーする方法の例を次に示します。

Visual Basic

Const size As Integer =
 4096
Dim bytes(4096) As Byte
Dim numBytes As Integer
numBytes = input.Read(bytes, 0, size)
While numBytes > 0
    output.Write(bytes, 0, numBytes)
    numBytes = input.Read(bytes, 0, size)
End While

const int size = 4096;
byte[] bytes = new byte[4096];
int numBytes;
while((numBytes = input.Read(bytes, 0, size)) > 0)
    output.Write(bytes, 0, numBytes);

C++

const int size = 4096;
array<Byte>^ bytes = gcnew array<Byte>(4096);
int numBytes;
while ( (numBytes = input->Read( bytes, 0, size )) > 0 )
      output->Write( bytes, 0, numBytes );

final int size = 4096;
ubyte bytes[] = new ubyte[4096];
int numBytes;
while (((numBytes = input.Read(bytes, 0, size)) > 0)) {
    output.Write(bytes, 0, numBytes);
}