Stream.SetLength(Int64) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
在衍生類別中覆寫時,設定目前資料流的長度。
public:
abstract void SetLength(long value);
public abstract void SetLength (long value);
abstract member SetLength : int64 -> unit
Public MustOverride Sub SetLength (value As Long)
參數
- value
- Int64
想要的目前資料流長度 (單位為位元組)。
例外狀況
發生 I/O 錯誤。
資料流不支援寫入和搜尋,例如,如果資料流是從管道或主控台 (Console) 輸出所建構。
關閉資料流後呼叫了方法。
備註
如果指定的值小於數據流的目前長度,則會截斷數據流。 如果指定的值大於數據流目前的長度,則會展開數據流。 如果數據流已展開,則不會定義舊長度和新長度之間的數據流內容。
數據流必須同時支援撰寫和尋求 SetLength
工作。
CanWrite使用 屬性來判斷目前的實例是否支援寫入,以及CanSeek屬性來判斷是否支持搜尋。