FileStream.SetLength(Int64) 方法

  • 參考

定義

命名空間:
System.IO
組件:
mscorlib.dll, System.IO.FileSystem.dll
組件:
System.Runtime.dll
組件:
System.IO.FileSystem.dll
組件:
mscorlib.dll
組件:
netstandard.dll
來源:
FileStream.cs
來源:
FileStream.cs
來源:
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 工作。

適用於

另請參閱