FileStream.Write メソッド

.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)

C#

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

C++

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

J#

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

C#

// 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 ) );
}

J#

// 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

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

バージョン情報

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

参照

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