StringBuilder-Konstruktor (String, Int32)

Initialisiert eine neue Instanz der StringBuilder-Klasse unter Verwendung der angegebenen Zeichenfolge und der angegebenen Kapazität.

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

Syntax

'Declaration
Public Sub New ( _
    value As String, _
    capacity As Integer _
)
'Usage
Dim value As String
Dim capacity As Integer

Dim instance As New StringBuilder(value, capacity)

public StringBuilder (
    string value,
    int capacity
)

public:
StringBuilder (
    String^ value, 
    int capacity
)

public StringBuilder (
    String value, 
    int capacity
)

public function StringBuilder (
    value : String, 
    capacity : int
)

Parameter

• value
  Die Zeichenfolge, mit der der Wert der Instanz initialisiert wird. Wenn valueNULL (Nothing in Visual Basic) ist, enthält der neue StringBuilder die leere Zeichenfolge (d. h., er enthält Empty).

• capacity
  Die empfohlene Anfangsgröße des StringBuilder.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentOutOfRangeException	capacity ist kleiner als 0 (null).

Hinweise

Wenn capacity 0 (null) ist, wird die implementierungsspezifische Standardkapazität verwendet.

Beispiel

Im folgenden Codebeispiel wird das Aufrufen des StringBuilder-Konstruktors mit einer Anfangszeichenfolge und einer angegebenen Kapazität veranschaulicht.

Dim initialString As String = "Initial string. "
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, capacity)

string initialString = "Initial string. ";
int capacity = 255;
StringBuilder stringBuilder = 
    new StringBuilder(initialString, capacity);

String^ initialString = L"Initial string. ";
int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder(
   initialString,capacity );

String initialString = "Initial string. ";
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(initialString, capacity);

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

StringBuilder-Klasse
StringBuilder-Member
System.Text-Namespace