MemoryStream.Write メソッド
バッファから読み取ったデータを使用して、現在のストリームにバイトのブロックを書き込みます。
Overrides Public Sub Write( _
ByVal buffer() As Byte, _ ByVal offset As Integer, _ ByVal count As Integer _)
[C#]
public override void Write(byte[] buffer,intoffset,intcount);
[C++]
public: void Write(unsigned charbuffer __gc[],intoffset,intcount);
[JScript]
public override function Write(
buffer : Byte[],offset : int,count : int);
パラメータ
- buffer
データの書き込み元となるバッファ。 - offset
書き込むデータの開始位置を示す buffer 内のバイト オフセット。 - count
書き込む最大バイト数。
例外
例外の種類 | 条件 |
---|---|
ArgumentNullException | buffer が null 参照 (Visual Basic では Nothing) です。 |
NotSupportedException | ストリームが書き込みをサポートしません。詳細については、 CanWrite のトピックを参照してください。
または 現在の位置が、ストリームの末尾に向かって count バイトよりも近い位置にあり、容量を変更できません。 |
ArgumentException | バッファ長から offset を差し引いた値が count より小さい値です。 |
ArgumentOutOfRangeException | offset または count が負の値です。 |
IOException | I/O エラーが発生しました。 |
ObjectDisposedException | 現在のストリーム インスタンスが閉じています。 |
解説
ファイルの作成およびテキストのファイルへの書き込みの例については、「 ファイルへのテキストの書き込み 」を参照してください。ファイルからのテキストの読み取りの例については、「 ファイルからのテキストの読み取り 」を参照してください。バイナリ ファイルからの読み取りおよびバイナリ ファイルへの書き込みの例については、「 新しく作成したデータ ファイルの読み取りと書き込み 」を参照してください。
このメソッドは、 Write をオーバーライドします。
offset パラメータは書き込む buffer の先頭バイトのオフセットを指定し、 count パラメータは書き込むバイト数を指定します。書き込み操作が正常に終了した場合、ストリームの現在位置は書き込んだバイト数だけ進みます。例外が発生した場合、ストリームの現在位置は変更されません。
byte[] パラメータで構築された MemoryStream 以外では、 MemoryStream の末尾で書き込み操作を実行すると、 MemoryStream が拡張されます。
使用例
[Visual Basic, C#, C++] このコード例は、 MemoryStream クラスの例の一部です。
' Write the first string to the stream.
memStream.Write(firstString, 0 , firstString.Length)
[C#]
// Write the first string to the stream.
memStream.Write(firstString, 0 , firstString.Length);
[C++]
// Write the first string to the stream.
memStream->Write(firstString, 0 , firstString->Length);
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard
参照
MemoryStream クラス | MemoryStream メンバ | System.IO 名前空間 | 入出力操作 | ファイルからのテキストの読み取り | ファイルへのテキストの書き込み