MemoryStream.Capacity 屬性

定義

取得或設定配置給這個資料流的位元組數目。Gets or sets the number of bytes allocated for this stream.

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

屬性值

資料流緩衝區可使用部分的長度。The length of the usable portion of the buffer for the stream.

例外狀況

設定的容量為負數或小於資料流目前的長度。A capacity is set that is negative or less than the current length of the stream.

目前的資料流已關閉。The current stream is closed.

set 在無法修改其容量的資料流上被叫用 (Invoke)。set is invoked on a stream whose capacity cannot be modified.

範例

這個程式碼範例是針對MemoryStream類別提供之較大範例的一部分。This code example is part of a larger example provided for the MemoryStream class.

// 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 is the buffer length for system-provided byte arrays. Capacity不能設定為小於目前資料流程長度的值。Capacity cannot be set to a value less than the current length of the stream.

適用於

另請參閱