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 サポートされているかどうかを判断するにはプロパティを使用します。

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0