このドキュメントはアーカイブされており、メンテナンスされていません。

FileStream.Write メソッド

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

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

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

パラメータ

array

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

offset

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

count

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

例外の種類条件

ArgumentNullException

array が null 参照 (Visual Basic では Nothing) です。

ArgumentException

offsetcountarray の無効な範囲を示しています。

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 メソッドの例の一部です。

// Write the original file data.
if(fileStream.Length == 0)
{
    tempString = 
        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

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

.NET Framework

サポート対象 : 2.0、1.1、1.0

.NET Compact Framework

サポート対象 : 2.0、1.0
表示: