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)

想要的目前資料流長度 (單位為位元組)。

IOException

發生 I/O 錯誤。

資料流不支援寫入和搜尋，例如，如果資料流是從管道或主控台 (Console) 輸出所建構。

關閉資料流後呼叫了方法。

如果指定的值小於資料流程的目前長度，則會截斷資料流程。如果指定的值大於資料流程目前的長度，則會展開資料流程。如果資料流程已展開，則不會定義舊長度和新長度之間的資料流程內容。

資料流程必須同時支援撰寫和尋求 SetLength 工作。

CanWrite使用屬性來判斷目前的實例是否支援寫入，以及 CanSeek 屬性來判斷是否支援搜尋。