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
| 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
- 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 = 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.
Gilt für:
StringBuilder(Int32)
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- 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.StringBuilderPublic Sub New (capacity As Integer)Parameter
- capacity
- Int32
Die empfohlene Anfangsgröße dieser Instanz.
Ausnahmen
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
Gilt für:
StringBuilder(String)
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
Initialisiert eine neue Instanz der StringBuilder-Klasse unter Verwendung der 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 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).
Gilt für:
StringBuilder(Int32, Int32)
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- 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.StringBuilderPublic 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
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
Gilt für:
StringBuilder(String, Int32)
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- 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);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 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
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
Gilt für:
StringBuilder(String, Int32, Int32, Int32)
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- 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);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, 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
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.
