MemoryStream.Capacity-Eigenschaft

Artikel
08/20/2007

Ruft die Anzahl der für diesen Stream reservierten Bytes ab oder legt diese fest.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Overridable Property Capacity As Integer
'Usage
Dim instance As MemoryStream
Dim value As Integer

value = instance.Capacity

instance.Capacity = value

public virtual int Capacity { get; set; }

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

/** @property */
public int get_Capacity ()

/** @property */
public void set_Capacity (int value)

public function get Capacity () : int

public function set Capacity (value : int)

Eigenschaftenwert

Die Länge des Bereichs, der für den Stream im Puffer verwendet werden kann.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentOutOfRangeException	Es wurde eine Kapazität festgelegt, die negativ oder kleiner als die derzeitige Länge des Streams ist.
ObjectDisposedException	Der aktuelle Stream ist geschlossen.
NotSupportedException	set wird für einen Stream aufgerufen, dessen Kapazität nicht geändert werden kann.

Hinweise

Ein Beispiel für das Erstellen einer Datei und das Schreiben von Text in eine Datei finden Sie unter Gewusst wie: Schreiben von Text in eine Datei. Ein Beispiel für das Lesen von Text aus einer Datei finden Sie unter Gewusst wie: Lesen aus einer Textdatei. Ein Beispiel für das Lesen aus einer Binärdatei und das Schreiben in eine Binärdatei finden Sie unter Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei.

Capacity ist die Pufferlänge für vom System bereitgestellte Bytearrays. Capacity kann nicht auf einen Wert festgelegt werden, der kleiner als die aktuelle Länge des Streams ist.

Beispiel

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die MemoryStream-Klasse.

' Write the stream properties to the console.
Console.WriteLine( _
    "Capacity = {0}, Length = {1}, Position = {2}", _
    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}\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", 
    (new Integer( memStream.get_Capacity())).ToString(),
    (new Long ( memStream.get_Length())).ToString(),
    (new Long ( memStream.get_Position())).ToString());

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

MemoryStream-Klasse
MemoryStream-Member
System.IO-Namespace

Weitere Ressourcen

Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei

Freigeben über