BufferedStream.SetLength メソッド

バッファ ストリーム長を設定します。

Overrides Public Sub SetLength( _
   ByVal value As Long _)
[C#]
public override void SetLength(longvalue);
[C++]
public: void SetLength(__int64value);
[JScript]
public override function SetLength(
   value : long);

パラメータ

• value
  必要な現在のバッファ ストリーム長を示す整数 (バイト単位)。

例外

例外の種類	条件
ArgumentOutOfRangeException	value が負の値です。
IOException	ストリームが開いていないか、 null 参照 (Visual Basic では Nothing) になっています。
NotSupportedException	ストリームが書き込みもシークもサポートしていません。
ObjectDisposedException	ストリームが閉じられた後でメソッドが呼び出されました。

解説

ファイルの作成およびテキストのファイルへの書き込みの例については、「 ファイルへのテキストの書き込み 」を参照してください。ファイルからのテキストの読み取りの例については、「 ファイルからのテキストの読み取り 」を参照してください。バイナリ ファイルの読み取りおよび書き込みの例については、「 新しく作成したデータ ファイルの読み取りと書き込み 」を参照してください。

バッファは、基になるデータ ソースまたはリポジトリの長さを設定する前にフラッシュされます。バッファ ストリームの現在の長さより小さい値を指定した場合は、バッファ ストリームが切り捨てられます。指定した値が現在のバッファ ストリーム長より大きい場合、バッファ ストリームは拡張されます。バッファ ストリームが拡張された場合、元のストリーム長と新しいストリーム長の間のバッファ ストリームの内容は不明です。

SetLength は、必要に応じてバッファに格納された書き込みをフラッシュします。

SetLength が機能するためには、ストリームが書き込みとシークの両方をサポートしていることが必要です

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

BufferedStream クラス | BufferedStream メンバ | System.IO 名前空間 | Seek | 入出力操作 | ファイルからのテキストの読み取り | ファイルへのテキストの書き込み