Share via

Stream.SetLength メソッド

  • [アーティクル]

派生クラスでオーバーライドされた場合は、現在のストリームの長さを設定します。

Public MustOverride Sub SetLength( _
   ByVal value As Long _)
[C#]
public abstract void SetLength(longvalue);
[C++]
public: virtual void SetLength(__int64value) = 0;
[JScript]
public abstract function SetLength(
   value : long);

パラメータ

  • value
    現在のストリームの希望の長さ (バイト数)。

例外

例外の種類 条件
IOException I/O エラーが発生しました。
NotSupportedException ストリームが書き込みとシークの両方をサポートしていません。たとえば、ストリームがパイプまたはコンソール出力によって生成された可能性があります。
ObjectDisposedException ストリームが閉じられた後でメソッドが呼び出されました。

解説

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

ストリームの現在の長さより小さい値を指定した場合は、ストリームが切り捨てられます。ストリームの現在の長さより大きい値を設定した場合は、ストリームが拡張されます。ストリームが拡張された場合、元の長さと新しい長さの間のストリームの内容は不明です。

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

CanWrite プロパティを使用して、現在のインスタンスが書き込みをサポートしているかどうかを判断します。また、 CanSeek プロパティを使用して、シークをサポートしているかどうかを判断します。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

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