MemoryStream.Capacity 屬性

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

MemoryStream.cs

取得或設定配置給這個資料流的位元組數目。

public:
 virtual property int Capacity { int get(); void set(int value); };

public virtual int Capacity { get; set; }

member this.Capacity : int with get, set

Public Overridable Property Capacity As Integer

屬性值

Int32

資料流緩衝區可使用部分的長度。

例外狀況

ArgumentOutOfRangeException

設定的容量為負數或小於資料流目前的長度。

ObjectDisposedException

目前的資料流已關閉。

NotSupportedException

set 在無法修改其容量的資料流上被叫用 (Invoke)。

範例

此程式碼範例是提供給 類別之較大範例的 MemoryStream 一部分。

// Write the stream properties to the console.
Console::WriteLine( "Capacity = {0}, Length = {1}, "
"Position = {2}\n", memStream->Capacity.ToString(), memStream->Length.ToString(), memStream->Position.ToString() );

// Write the stream properties to the console.
Console.WriteLine(
    "Capacity = {0}, Length = {1}, Position = {2}\n",
    memStream.Capacity.ToString(),
    memStream.Length.ToString(),
    memStream.Position.ToString());

' Write the stream properties to the console.
Console.WriteLine( _
    "Capacity = {0}, Length = {1}, Position = {2}", _
    memStream.Capacity.ToString(), _
    memStream.Length.ToString(), _
    memStream.Position.ToString())

備註

Capacity 是系統提供位元組陣列的緩衝區長度。 Capacity 無法設定為小於資料流程目前長度的值。

另請參閱

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