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 工作。

另請參閱

• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案