BufferedStream.SetLength メソッド

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

BufferedStream.SetLength メソッド

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

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

Visual Basic (宣言)

Public Overrides Sub SetLength
 ( _
    value As Long _
)

Visual Basic (使用法)

Dim instance As BufferedStream
Dim value As Long

instance.SetLength(value)

C#

public override void SetLength (
    long value
)

C++

public:
virtual void SetLength (
    long long value
) override

J#

public void SetLength (
    long value
)

JScript

public override function SetLength (
    value : long
)

パラメータ

value

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

例外

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

解説

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

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

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

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

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