MemoryStream.Write メソッド

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

MemoryStream.Write メソッド

バッファから読み取ったデータを使用して、現在のストリームにバイトのブロックを書き込みます。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

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

instance.Write(buffer, offset, count)

C#

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

C++

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

J#

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

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 が拡張されます。

使用例

このコード例は、MemoryStream クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' 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 );

J#

// Write the first string to the stream.
memStream.Write(firstString, 0, firstString.length);

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
MemoryStream クラス
MemoryStream メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む