Stream.SetLength(Int64) メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

public:
 abstract void SetLength(long value);

public abstract void SetLength (long value);

abstract member SetLength : int64 -> unit

Public MustOverride Sub SetLength (value As Long)

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

IOException

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

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

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

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

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

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