Stream.SetLength(Int64) メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

Source:

Stream.cs

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

public:
 abstract void SetLength(long value);

public abstract void SetLength (long value);

abstract member SetLength : int64 -> unit

Public MustOverride Sub SetLength (value As Long)

パラメーター

value

Int64

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

例外

IOException

I/O エラーが発生します。

NotSupportedException

ストリームが書き込みとシークの両方をサポートしていません。たとえば、ストリームがパイプまたはコンソール出力によって生成された可能性があります。

ObjectDisposedException

ストリームが閉じた後でメソッドが呼び出されました。

注釈

指定した値がストリームの現在の長さより小さい場合、ストリームは切り捨てられます。 指定した値がストリームの現在の長さより大きい場合、ストリームは展開されます。 ストリームが展開されている場合、古い長さと新しい長さの間のストリームの内容は定義されません。

ストリームは、書き込みとシークの SetLength 両方をサポートする必要があります。

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

こちらもご覧ください

• ファイルおよびストリーム入出力
• 方法: ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み