StringBuilder Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Initialisiert eine neue Instanz der StringBuilder-Klasse.
Überlädt
| Name | Beschreibung |
|---|---|
| StringBuilder() |
Initialisiert eine neue Instanz der StringBuilder-Klasse. |
| StringBuilder(Int32) |
Initialisiert eine neue Instanz der Klasse mithilfe der StringBuilder angegebenen Kapazität. |
| StringBuilder(String) |
Initialisiert eine neue Instanz der Klasse mithilfe der StringBuilder angegebenen Zeichenfolge. |
| StringBuilder(Int32, Int32) |
Initialisiert eine neue Instanz der StringBuilder Klasse, die mit einer angegebenen Kapazität beginnt und auf ein angegebenes Maximum anwachsen kann. |
| StringBuilder(String, Int32) |
Initialisiert eine neue Instanz der Klasse mithilfe der StringBuilder angegebenen Zeichenfolge und Kapazität. |
| StringBuilder(String, Int32, Int32, Int32) |
Initialisiert eine neue Instanz der StringBuilder Klasse aus der angegebenen Teilzeichenfolge und Kapazität. |
StringBuilder()
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- 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 = new StringBuilder();
let stringBuilder = StringBuilder()
Dim stringBuilder As New StringBuilder
Hinweise
Der Zeichenfolgenwert dieser Instanz ist auf String.Empty, und die Kapazität wird auf die implementierungsspezifische Standardkapazität festgelegt.
Gilt für:
StringBuilder(Int32)
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
Initialisiert eine neue Instanz der Klasse mithilfe der StringBuilder angegebenen Kapazität.
public:
StringBuilder(int capacity);public StringBuilder(int capacity);new System.Text.StringBuilder : int -> System.Text.StringBuilderPublic Sub New (capacity As Integer)Parameter
- capacity
- Int32
Die vorgeschlagene Anfangsgröße dieser Instanz.
Ausnahmen
capacity ist kleiner als 0 (null).
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie der StringBuilder Konstruktor mit einer angegebenen Kapazität aufgerufen wird.
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 von der aktuellen Instanz zugewiesenen Speicher gespeichert werden können. Der Wert wird der Capacity Eigenschaft zugewiesen. Wenn die Anzahl der Zeichen, die in der aktuellen Instanz gespeichert werden sollen, diesen capacity Wert überschreitet, weist das StringBuilder Objekt zusätzlichen Arbeitsspeicher zu, um sie zu speichern.
Der Zeichenfolgenwert dieser Instanz wird auf String.Empty. Wenn capacity null ist, wird die implementierungsspezifische Standardkapazität verwendet.
Weitere Informationen
Gilt für:
StringBuilder(String)
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
Initialisiert eine neue Instanz der Klasse mithilfe der StringBuilder angegebenen Zeichenfolge.
public:
StringBuilder(System::String ^ value);public StringBuilder(string value);public StringBuilder(string? value);new System.Text.StringBuilder : string -> System.Text.StringBuilderPublic Sub New (value As String)Parameter
- value
- String
Die zum Initialisieren des Werts der Instanz verwendete Zeichenfolge. Ist value dies nullder Grund, enthält die neue StringBuilder die leere Zeichenfolge (d Empty. a.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie der StringBuilder Konstruktor mit der angegebenen Zeichenfolge aufgerufen wird.
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
Ist value dies nullder Grund, enthält die neue StringBuilder die leere Zeichenfolge (d Empty. a.
Gilt für:
StringBuilder(Int32, Int32)
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
Initialisiert eine neue Instanz der StringBuilder Klasse, die mit einer angegebenen Kapazität beginnt und auf ein angegebenes Maximum anwachsen kann.
public:
StringBuilder(int capacity, int maxCapacity);public StringBuilder(int capacity, int maxCapacity);new System.Text.StringBuilder : int * int -> System.Text.StringBuilderPublic Sub New (capacity As Integer, maxCapacity As Integer)Parameter
- capacity
- Int32
Die vorgeschlagene Anfangsgröße der StringBuilder.
- maxCapacity
- Int32
Die maximale Anzahl von Zeichen, die die aktuelle Zeichenfolge enthalten kann.
Ausnahmen
maxCapacity ist kleiner als ein Wert, capacity ist kleiner als Null oder capacity 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 =
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 von der aktuellen Instanz zugewiesenen Speicher gespeichert werden können. Der Wert wird der Capacity Eigenschaft zugewiesen. Wenn die Anzahl der Zeichen, die in der aktuellen Instanz gespeichert werden sollen, 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 die aktuelle Instanz enthalten kann. Der Wert wird der MaxCapacity Eigenschaft zugewiesen. Wenn die Anzahl der Zeichen, die in der aktuellen Instanz gespeichert werden sollen, 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 das StringBuilder Objekt in .NET Core und in den .NET Framework 4.0- und höheren Versionen instanziieren, indem Sie den StringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität der StringBuilder Instanz über den Wert seiner MaxCapacity Eigenschaft hinaus wachsen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Zeichenfolgen aufrufen und AppendFormat(String, Object) Methoden zum Anfügen kleiner Zeichenfolgen verwenden.
Weitere Informationen
Gilt für:
StringBuilder(String, Int32)
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
Initialisiert eine neue Instanz der Klasse mithilfe der StringBuilder angegebenen Zeichenfolge und Kapazität.
public:
StringBuilder(System::String ^ value, int capacity);public StringBuilder(string value, int capacity);public StringBuilder(string? value, int capacity);new System.Text.StringBuilder : string * int -> System.Text.StringBuilderPublic Sub New (value As String, capacity As Integer)Parameter
- value
- String
Die zum Initialisieren des Werts der Instanz verwendete Zeichenfolge. Ist value dies nullder Grund, enthält die neue StringBuilder die leere Zeichenfolge (d Empty. a.
- capacity
- Int32
Die vorgeschlagene Anfangsgröße der StringBuilder.
Ausnahmen
capacity ist kleiner als 0 (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 = "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 von der aktuellen Instanz zugewiesenen Speicher gespeichert werden können. Der Wert wird der Capacity Eigenschaft zugewiesen. Wenn die Anzahl der Zeichen, die in der aktuellen Instanz gespeichert werden sollen, 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
Gilt für:
StringBuilder(String, Int32, Int32, Int32)
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
Initialisiert eine neue Instanz der StringBuilder Klasse aus der angegebenen Teilzeichenfolge und Kapazität.
public:
StringBuilder(System::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);new System.Text.StringBuilder : string * int * int * int -> System.Text.StringBuilderPublic Sub New (value As String, startIndex As Integer, length As Integer, capacity As Integer)Parameter
- value
- String
Die Zeichenfolge, die die Teilzeichenfolge enthält, die zum Initialisieren des Werts dieser Instanz verwendet wird. Ist value dies nullder Grund, enthält die neue StringBuilder die leere Zeichenfolge (d Empty. a.
- startIndex
- Int32
Die Position, an value der die Teilzeichenfolge beginnt.
- length
- Int32
Die Anzahl der Zeichen in der Teilzeichenfolge.
- capacity
- Int32
Die vorgeschlagene Anfangsgröße der StringBuilder.
Ausnahmen
capacity ist kleiner als 0 (null).
- oder -
startIndex plus length ist keine Position innerhalb value.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie der StringBuilder Konstruktor mit der angegebenen Zeichenfolge aufgerufen wird.
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 von der aktuellen Instanz zugewiesenen Speicher gespeichert werden können. Der Wert wird der Capacity Eigenschaft zugewiesen. Wenn die Anzahl der Zeichen, die in der aktuellen Instanz gespeichert werden sollen, 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.
