FileStream.SetLength(Int64) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
設定這個資料流長度為指定的數值。
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
工作。
如需一般檔案和目錄作業的清單,請參閱 一般 I/O 工作。