FileStream.SetLength(Int64) メソッド

定義

ストリーム長を特定の値に設定します。

public:
 override void SetLength(long value);
public override void SetLength (long value);
override this.SetLength : int64 -> unit
Public Overrides Sub SetLength (value As Long)

パラメーター

value
Int64

ストリームの新しい長さ。

例外

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

ストリームでは、書き込みとシークの両方は使用できません。

value パラメーターを 0 未満の値に設定しようとしました。

注釈

このメソッドは、SetLength をオーバーライドします。

指定された値がストリームの現在の長さより小さい場合、ストリームは切り捨てられます。 このシナリオでは、現在の位置が新しい長さを超える場合、現在の位置はストリームの最後のバイトに移動されます。 指定された値がストリームの現在の長さよりも大きい場合、ストリームは展開され、現在の位置は変わりません。 ストリームが展開されている場合、古い長さと新しい長さの間のストリームの内容は Windows では定義されていませんが、Linux では、その領域は 0 で埋められます。

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

Note

現在のインスタンスが CanWrite 書き込みをサポートしているかどうかを判断するには プロパティを使用し CanSeek 、シークがサポートされているかどうかを判断するには プロパティを使用します。 追加情報については、CanWrite、および CanSeek を参照してください。

一般的なファイル操作とディレクトリ操作の一覧については、「 一般的な I/O タスク」を参照してください。

適用対象

こちらもご覧ください