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

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

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

FileStream.Write メソッド

バッファのデータを使用して、ストリームにバイトのブロックを書き込みます。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As FileStream
Dim array As Byte()
Dim offset As Integer
Dim count As Integer

instance.Write(array, offset, count)

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

C++

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

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

JScript

public override function Write (
    array : byte[], 
    offset : int, 
    count : int
)

パラメータ

array: ストリームに書き込むデータを格納しているバッファ。

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

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

例外

例外の種類	条件
ArgumentNullException	array が null 参照 (Visual Basic では Nothing) です。
ArgumentException	offset と count が array の無効な範囲を示しています。
ArgumentOutOfRangeException	offset または count が負の値です。
IOException	I/O エラーが発生しました。または別のスレッドによって、オペレーティングシステムのファイルハンドルの位置に予期しない変更が行われている可能性があります。
ObjectDisposedException	ストリームが閉じられました。
NotSupportedException	現在のストリームインスタンスは書き込みをサポートしていません。

解説

このメソッドは、Write をオーバーライドします。

offset パラメータは array 内のストリームへのコピーを開始する位置のバイトのオフセット (バッファインデックス) を指定し、count パラメータはストリームに書き込む最大バイト数を指定します。書き込み操作が正常に終了した場合、ストリームの現在位置は書き込んだバイト数だけ進みます。例外が発生した場合、ストリームの現在位置は変更されません。

メモ
現在のインスタンスが書き込みをサポートしているかどうかを判断するには、CanWrite プロパティを使用します。詳細については、CanWrite のトピックを参照してください。

その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ファイルのサイズを取得する。	FileInfo.Length
ファイルの属性を取得する。	File.GetAttributes
ファイルの属性を設定する。	File.SetAttributes
ファイルが存在するかどうかを判別する。	File.Exists
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする
ディレクトリを作成する。	Directory.CreateDirectory Directory.CreateDirectory

使用例

次のコード例は Lock メソッドの例の一部です。

Visual Basic

' Write the original file data.
If aFileStream.Length = 0 Then
    tempString = _
        lastRecordText + recordNumber.ToString()
    aFileStream.Write(uniEncoding.GetBytes(tempString), _
        0, uniEncoding.GetByteCount(tempString))
End If

// Write the original file data.
if(fileStream.Length == 0)
{
    tempString = 
        lastRecordText + recordNumber.ToString();
    fileStream.Write(uniEncoding.GetBytes(tempString), 
        0, uniEncoding.GetByteCount(tempString));
}

C++

// Write the original file data.
if ( fileStream->Length == 0 )
{
   tempString = String::Concat( lastRecordText, recordNumber.ToString() );
   fileStream->Write( uniEncoding->GetBytes( tempString ), 0, uniEncoding->GetByteCount(
 tempString ) );
}

// Write the original file data.
if ( fileStream.get_Length() == 0  ) {
    tempString = lastRecordText +(
        new Integer( recordNumber)).ToString();
    fileStream.Write(uniEncoding.GetBytes(tempString),
        0, uniEncoding.GetByteCount(tempString));
}

プラットフォーム

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