StringBuilder Konstruktoren

Definition

Namespace:

System.Text

Assembly:

System.Runtime.dll

Initialisiert eine neue Instanz der StringBuilder-Klasse.

Überlädt

StringBuilder()	Initialisiert eine neue Instanz der StringBuilder-Klasse.
StringBuilder(Int32)	Initialisiert eine neue Instanz der StringBuilder-Klasse unter Verwendung der angegebenen Kapazität.
StringBuilder(String)	Initialisiert eine neue Instanz der StringBuilder-Klasse unter Verwendung der angegebenen Zeichenfolge.
StringBuilder(Int32, Int32)	Initialisiert eine neue Instanz der StringBuilder-Klasse, die bei einer angegebenen Kapazität beginnt, die bis auf ein angegebenes Maximum erhöht werden kann.
StringBuilder(String, Int32)	Initialisiert eine neue Instanz der StringBuilder-Klasse unter Verwendung der angegebenen Zeichenfolge und der angegebenen Kapazität.
StringBuilder(String, Int32, Int32, Int32)	Initialisiert eine neue Instanz der StringBuilder-Klasse unter Verwendung der angegebenen Teilzeichenfolge und der angegebenen Kapazität.

StringBuilder()

Quelle:

StringBuilder.cs

Initialisiert eine neue Instanz der StringBuilder-Klasse.

public:
 StringBuilder();

public StringBuilder ();

Public Sub New ()

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie der StringBuilder Konstruktor ohne Parameter aufgerufen wird.

StringBuilder^ stringBuilder = gcnew StringBuilder;

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

Hinweise

Der Zeichenfolgenwert dieses instance ist auf String.Emptyfestgelegt, und die Kapazität wird auf die implementierungsspezifische Standardkapazität festgelegt.

StringBuilder(Int32)

Quelle:

StringBuilder.cs

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

public:
 StringBuilder(int capacity);

public StringBuilder (int capacity);

new System.Text.StringBuilder : int -> System.Text.StringBuilder

Public Sub New (capacity As Integer)

Parameter

capacity

Int32

Die empfohlene Anfangsgröße dieser Instanz.

Ausnahmen

ArgumentOutOfRangeException

capacity ist kleiner als Null.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie der StringBuilder Konstruktor mit einer angegebenen Kapazität aufgerufen wird.

int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity );

int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(capacity);

let capacity = 255
let stringBuilder = StringBuilder capacity

Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(capacity)

Hinweise

Der capacity Parameter definiert die maximale Anzahl von Zeichen, die im Speicher gespeichert werden können, der vom aktuellen instance zugewiesen wird. Ihr Wert wird der Capacity -Eigenschaft zugewiesen. Wenn die Anzahl der im aktuellen instance zu speichernden Zeichen diesen capacity Wert überschreitet, weist das StringBuilder Objekt zusätzlichen Arbeitsspeicher zu, um sie zu speichern.

Der Zeichenfolgenwert dieses instance ist auf String.Emptyfestgelegt. Wenn capacity null ist, wird die implementierungsspezifische Standardkapazität verwendet.

Weitere Informationen

• Capacity

StringBuilder(String)

Quelle:

StringBuilder.cs

Initialisiert eine neue Instanz der StringBuilder-Klasse unter Verwendung der angegebenen Zeichenfolge.

public:
 StringBuilder(System::String ^ value);

public StringBuilder (string? value);

new System.Text.StringBuilder : string -> System.Text.StringBuilder

Public Sub New (value As String)

Parameter

value

String

Die Zeichenfolge, mit der der Wert der Instanz initialisiert wird. Wenn valuenull ist, enthält der neue StringBuilder die leere Zeichenfolge (d. h., er enthält Empty).

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie der StringBuilder Konstruktor mit der angegebenen Zeichenfolge aufgerufen wird.

String^ initialString = L"Initial string.";
StringBuilder^ stringBuilder = gcnew StringBuilder( initialString );

string initialString = "Initial string.";
StringBuilder stringBuilder = new StringBuilder(initialString);

let initialString = "Initial string."
let stringBuilder = StringBuilder initialString

Dim initialString As String = "Initial string."
Dim stringBuilder As New StringBuilder(initialString)

Hinweise

Wenn valuenull ist, enthält der neue StringBuilder die leere Zeichenfolge (d. h., er enthält Empty).

StringBuilder(Int32, Int32)

Quelle:

StringBuilder.cs

Initialisiert eine neue Instanz der StringBuilder-Klasse, die bei einer angegebenen Kapazität beginnt, die bis auf ein angegebenes Maximum erhöht werden kann.

public:
 StringBuilder(int capacity, int maxCapacity);

public StringBuilder (int capacity, int maxCapacity);

new System.Text.StringBuilder : int * int -> System.Text.StringBuilder

Public Sub New (capacity As Integer, maxCapacity As Integer)

Parameter

capacity

Int32

Die empfohlene Anfangsgröße des StringBuilder.

maxCapacity

Int32

Die Höchstanzahl von Zeichen, die die aktuelle Zeichenfolge enthalten kann.

Ausnahmen

ArgumentOutOfRangeException

maxCapacity ist kleiner als 1, capacity ist kleiner als 0 (null), oder capacity ist größer als maxCapacity.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie der StringBuilder Konstruktor mit einer angegebenen Kapazität und maximaler Kapazität aufgerufen wird.

int capacity = 255;
int maxCapacity = 1024;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity,maxCapacity );

int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new StringBuilder(capacity, maxCapacity);

let capacity = 255
let maxCapacity = 1024
let stringBuilder = StringBuilder(capacity, maxCapacity)

Dim capacity As Integer = 255
Dim maxCapacity As Integer = 1024
Dim stringBuilder As New StringBuilder(capacity, maxCapacity)

Hinweise

Der capacity Parameter definiert die maximale Anzahl von Zeichen, die im Speicher gespeichert werden können, der vom aktuellen instance zugewiesen wird. Ihr Wert wird der Capacity -Eigenschaft zugewiesen. Wenn die Anzahl der im aktuellen instance zu speichernden Zeichen diesen capacity Wert überschreitet, weist das StringBuilder Objekt zusätzlichen Arbeitsspeicher zu, um sie zu speichern.

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

Die maxCapacity -Eigenschaft definiert die maximale Anzahl von Zeichen, die der aktuelle instance enthalten kann. Ihr Wert wird der MaxCapacity -Eigenschaft zugewiesen. Wenn die Anzahl der im aktuellen instance zu speichernden Zeichen diesen maxCapacity Wert überschreitet, weist das StringBuilder Objekt keinen zusätzlichen Arbeitsspeicher zu, sondern löst stattdessen eine Ausnahme aus.

Hinweise für Aufrufer

Wenn Sie in .NET Core und in der .NET Framework 4.0 und höher das Objekt instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität des StringBuilder instance den Wert seiner MaxCapacity Eigenschaft überschreiten. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

• Capacity
• MaxCapacity

StringBuilder(String, Int32)

Quelle:

StringBuilder.cs

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

public:
 StringBuilder(System::String ^ value, int capacity);

public StringBuilder (string? value, int capacity);

new System.Text.StringBuilder : string * int -> System.Text.StringBuilder

Public Sub New (value As String, capacity As Integer)

Parameter

value

String

Die Zeichenfolge, mit der der Wert der Instanz initialisiert wird. Wenn valuenull ist, enthält der neue StringBuilder die leere Zeichenfolge (d. h., er enthält Empty).

capacity

Int32

Die empfohlene Anfangsgröße des StringBuilder.

Ausnahmen

ArgumentOutOfRangeException

capacity ist kleiner als Null.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie der StringBuilder Konstruktor mit einer anfänglichen Zeichenfolge und einer angegebenen Kapazität aufgerufen wird.

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);

let initialString = "Initial string. "
let capacity = 255
let stringBuilder = StringBuilder(initialString, capacity)

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

Hinweise

Der capacity Parameter definiert die maximale Anzahl von Zeichen, die im Speicher gespeichert werden können, der vom aktuellen instance zugewiesen wird. Ihr Wert wird der Capacity -Eigenschaft zugewiesen. Wenn die Anzahl der im aktuellen instance zu speichernden Zeichen diesen capacity Wert überschreitet, weist das StringBuilder Objekt zusätzlichen Arbeitsspeicher zu, um sie zu speichern.

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

Weitere Informationen

• Capacity

StringBuilder(String, Int32, Int32, Int32)

Quelle:

StringBuilder.cs

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

public:
 StringBuilder(System::String ^ value, int startIndex, int length, int capacity);

public StringBuilder (string? value, int startIndex, int length, int capacity);

new System.Text.StringBuilder : string * int * int * int -> System.Text.StringBuilder

Public Sub New (value As String, startIndex As Integer, length As Integer, capacity As Integer)

Parameter

value

String

Die Zeichenfolge, die die Teilzeichenfolge enthält, mit der der Wert dieser Instanz initialisiert wird. Wenn valuenull ist, enthält der neue StringBuilder die leere Zeichenfolge (d. h., er enthält Empty).

startIndex

Int32

Die Position in value, an der die Teilzeichenfolge beginnt.

length

Int32

Die Anzahl der Zeichen in der Teilzeichenfolge.

capacity

Int32

Die empfohlene Anfangsgröße des StringBuilder.

Ausnahmen

ArgumentOutOfRangeException

capacity ist kleiner als Null.

- oder -

startIndex plus length ist keine Position in value.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie der StringBuilder Konstruktor mit der angegebenen Zeichenfolge aufgerufen wird.

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);

let initialString = "Initial string for stringbuilder."
let startIndex = 0
let substringLength = 14
let capacity = 255

let stringBuilder =
    StringBuilder(initialString, startIndex, substringLength, capacity)

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)

Hinweise

Der capacity Parameter definiert die maximale Anzahl von Zeichen, die im Speicher gespeichert werden können, der vom aktuellen instance zugewiesen wird. Ihr Wert wird der Capacity -Eigenschaft zugewiesen. Wenn die Anzahl der im aktuellen instance zu speichernden Zeichen diesen capacity Wert überschreitet, weist das StringBuilder Objekt zusätzlichen Arbeitsspeicher zu, um sie zu speichern.

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

Weitere Informationen

• Capacity