FileStream.SetLength(Int64) メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

ソース:

FileStream.cs

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

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

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

例外

IOException

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

NotSupportedException

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

ArgumentOutOfRangeException

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

注釈

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

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

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

注意

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

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

こちらもご覧ください

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