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 では、その領域はゼロで埋められます。

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

注意

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

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

適用対象

こちらもご覧ください