共用方式為


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屬性來判斷是否支持搜尋。 如需詳細資訊,請參閱 CanWriteCanSeek

如需一般檔案和目錄作業的清單,請參閱 一般 I/O 工作

適用於

另請參閱