FileStream.SetLength(Int64) メソッド
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ストリーム長を特定の値に設定します。
public:
override void SetLength(long value);public override void SetLength (long value);override this.SetLength : int64 -> unitPublic Overrides Sub SetLength (value As Long)- value
- Int64
ストリームの新しい長さ。
I/O エラーが発生しました。
ストリームでは、書き込みとシークの両方は使用できません。
value パラメーターを 0 未満の値に設定しようとしました。
このメソッドは、SetLength をオーバーライドします。
指定された値がストリームの現在の長さより小さい場合、ストリームは切り捨てられます。 このシナリオでは、現在の位置が新しい長さより大きい場合、現在の位置はストリームの最後のバイトに移動されます。 指定された値がストリームの現在の長さより大きい場合、ストリームは展開され、現在の位置は変わりません。 ストリームが展開されている場合、Windows では古い長さと新しい長さの間のストリームの内容が未定義になりますが、Linux では、その領域はゼロで埋められます。
ストリームは、書き込みとシークの SetLength 両方をサポートする必要があります。
注意
現在のインスタンスが CanWrite 書き込みをサポートしているかどうかを判断するには プロパティを使用し、シークが CanSeek サポートされているかどうかを判断するには プロパティを使用します。 追加情報については、CanWrite、および CanSeek を参照してください。
一般的なファイル操作とディレクトリ操作の一覧については、「 一般的な I/O タスク」を参照してください。
| 製品 | バージョン |
|---|---|
| .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.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。