Freigeben über


StringBuilder-Konstruktor (String, Int32, Int32, Int32)

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

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

Syntax

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

Dim instance As New StringBuilder(value, startIndex, length, capacity)
public StringBuilder (
    string value,
    int startIndex,
    int length,
    int capacity
)
public:
StringBuilder (
    String^ value, 
    int startIndex, 
    int length, 
    int capacity
)
public StringBuilder (
    String value, 
    int startIndex, 
    int length, 
    int capacity
)
public function StringBuilder (
    value : String, 
    startIndex : int, 
    length : int, 
    capacity : int
)

Parameter

  • value
    Die Zeichenfolge, die die Teilzeichenfolge enthält, mit der der Wert dieser Instanz initialisiert wird. Wenn valueNULL (Nothing in Visual Basic) ist, enthält der neue StringBuilder die leere Zeichenfolge (d. h., er enthält Empty).
  • startIndex
    Die Position in value, an der die Teilzeichenfolge beginnt.
  • length
    Die Anzahl der Zeichen in der Teilzeichenfolge.
  • capacity
    Die empfohlene Anfangsgröße des StringBuilder.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentOutOfRangeException

capacity ist kleiner als 0 (null).

– oder –

Die Summe von startIndex und length ist keine Position, die in value liegt.

Hinweise

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

Beispiel

Im folgenden Codebeispiel wird das Aufrufen des StringBuilder-Konstruktors mit der angegebenen Zeichenfolge veranschaulicht.

Dim initialString As String = "Initial string for stringbuilder."
Dim startIndex As Integer = 0
Dim substringLength As Integer = 14
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, _
    startIndex, substringLength, capacity)
string initialString = "Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(initialString, 
    startIndex, substringLength, capacity);
String^ initialString = L"Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder(
   initialString,startIndex,substringLength,capacity );
String initialString = "Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(initialString,
    startIndex, substringLength, 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