StringBuilder Konstruktory

Definice

Inicializuje novou instanci třídy StringBuilder.Initializes a new instance of the StringBuilder class.

Přetížení

StringBuilder()

Inicializuje novou instanci třídy StringBuilder.Initializes a new instance of the StringBuilder class.

StringBuilder(Int32)

Inicializuje novou instanci třídy StringBuilder pomocí zadané kapacity.Initializes a new instance of the StringBuilder class using the specified capacity.

StringBuilder(String)

Inicializuje novou instanci třídy StringBuilder pomocí zadaného řetězce.Initializes a new instance of the StringBuilder class using the specified string.

StringBuilder(Int32, Int32)

Inicializuje novou instanci třídy StringBuilder, která začíná zadanou kapacitou a může růst na určené maximum.Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

StringBuilder(String, Int32)

Inicializuje novou instanci třídy StringBuilder pomocí zadaného řetězce a kapacity.Initializes a new instance of the StringBuilder class using the specified string and capacity.

StringBuilder(String, Int32, Int32, Int32)

Inicializuje novou instanci třídy StringBuilder ze zadaného podřetězce a kapacity.Initializes a new instance of the StringBuilder class from the specified substring and capacity.

StringBuilder()

Inicializuje novou instanci třídy StringBuilder.Initializes a new instance of the StringBuilder class.

public:
 StringBuilder();
public StringBuilder ();
Public Sub New ()

Příklady

Následující příklad ukazuje, jak volat konstruktor StringBuilder bez parametrů.The following example demonstrates how to call the StringBuilder constructor with no parameters.

StringBuilder^ stringBuilder = gcnew StringBuilder;
StringBuilder stringBuilder = new StringBuilder();
Dim stringBuilder As New StringBuilder

Poznámky

Hodnota řetězce této instance je nastavená na String.Emptya kapacita je nastavená na výchozí kapacitu specifickou pro implementaci.The string value of this instance is set to String.Empty, and the capacity is set to the implementation-specific default capacity.

StringBuilder(Int32)

Inicializuje novou instanci třídy StringBuilder pomocí zadané kapacity.Initializes a new instance of the StringBuilder class using the specified capacity.

public:
 StringBuilder(int capacity);
public StringBuilder (int capacity);
new System.Text.StringBuilder : int -> System.Text.StringBuilder
Public Sub New (capacity As Integer)

Parametry

capacity
Int32

Navrhovaná počáteční velikost této instance.The suggested starting size of this instance.

Výjimky

Hodnota capacity je menší než nula.capacity is less than zero.

Příklady

Následující příklad ukazuje, jak volat konstruktor StringBuilder se zadanou kapacitou.The following example demonstrates how to call the StringBuilder constructor with a specified capacity.

int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity );
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(capacity);
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(capacity)

Poznámky

Parametr capacity definuje maximální počet znaků, které mohou být uloženy v paměti přidělené aktuální instancí.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Jeho hodnota je přiřazena vlastnosti Capacity.Its value is assigned to the Capacity property. Pokud počet znaků, které mají být uloženy v aktuální instanci, překračuje tuto capacity hodnotu, objekt StringBuilder přidělí další paměť pro jejich uložení.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Hodnota řetězce této instance je nastavená na String.Empty.The string value of this instance is set to String.Empty. Pokud je capacity nula, použije se výchozí kapacita specifická pro implementaci.If capacity is zero, the implementation-specific default capacity is used.

Viz také

StringBuilder(String)

Inicializuje novou instanci třídy StringBuilder pomocí zadaného řetězce.Initializes a new instance of the StringBuilder class using the specified string.

public:
 StringBuilder(System::String ^ value);
public StringBuilder (string value);
new System.Text.StringBuilder : string -> System.Text.StringBuilder
Public Sub New (value As String)

Parametry

value
String

Řetězec použitý k inicializaci hodnoty instance.The string used to initialize the value of the instance. Pokud je value null, bude nový StringBuilder obsahovat prázdný řetězec (to znamená, že obsahuje Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

Příklady

Následující příklad ukazuje, jak volat konstruktor StringBuilder se zadaným řetězcem.The following example demonstrates how to call the StringBuilder constructor with the specified string.

String^ initialString = L"Initial string.";
StringBuilder^ stringBuilder = gcnew StringBuilder( initialString );
string initialString = "Initial string.";
StringBuilder stringBuilder = new StringBuilder(initialString);
Dim initialString As String = "Initial string."
Dim stringBuilder As New StringBuilder(initialString)

Poznámky

Pokud je value null, bude nový StringBuilder obsahovat prázdný řetězec (to znamená, že obsahuje Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

StringBuilder(Int32, Int32)

Inicializuje novou instanci třídy StringBuilder, která začíná zadanou kapacitou a může růst na určené maximum.Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

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)

Parametry

capacity
Int32

Navrhovaná počáteční velikost StringBuilder.The suggested starting size of the StringBuilder.

maxCapacity
Int32

Maximální počet znaků, které může aktuální řetězec obsahovat.The maximum number of characters the current string can contain.

Výjimky

maxCapacity je menší než jedna, capacity je menší než nula nebo je capacity větší než maxCapacity.maxCapacity is less than one, capacity is less than zero, or capacity is greater than maxCapacity.

Příklady

Následující příklad ukazuje, jak volat konstruktor StringBuilder se zadanou kapacitou a maximální kapacitou.The following example demonstrates how to call the StringBuilder constructor with a specified capacity and maximum capacity.

int capacity = 255;
int maxCapacity = 1024;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity,maxCapacity );
int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new StringBuilder(capacity, maxCapacity);
Dim capacity As Integer = 255
Dim maxCapacity As Integer = 1024
Dim stringBuilder As New StringBuilder(capacity, maxCapacity)

Poznámky

Parametr capacity definuje maximální počet znaků, které mohou být uloženy v paměti přidělené aktuální instancí.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Jeho hodnota je přiřazena vlastnosti Capacity.Its value is assigned to the Capacity property. Pokud počet znaků, které mají být uloženy v aktuální instanci, překračuje tuto capacity hodnotu, objekt StringBuilder přidělí další paměť pro jejich uložení.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Pokud je capacity nula, použije se výchozí kapacita specifická pro implementaci.If capacity is zero, the implementation-specific default capacity is used.

Vlastnost maxCapacity definuje maximální počet znaků, které může aktuální instance uchovávat.The maxCapacity property defines the maximum number of characters that the current instance can hold. Jeho hodnota je přiřazena vlastnosti MaxCapacity.Its value is assigned to the MaxCapacity property. Pokud počet znaků, které mají být uloženy v aktuální instanci, překročí tuto maxCapacity hodnotu, objekt StringBuilder nealokuje další paměť, ale místo toho vyvolá výjimku.If the number of characters to be stored in the current instance exceeds this maxCapacity value, the StringBuilder object does not allocate additional memory, but instead throws an exception.

Poznámky pro volající

V rozhraní .NET Core a v .NET Framework 4,0 a novějších verzích při vytváření instance objektu StringBuilder voláním konstruktoru StringBuilder(Int32, Int32) může být délka i kapacita instance StringBuilder větší než hodnota jeho MaxCapacity vlastnosti.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. K tomu může dojít, zejména když zavoláte Append(String) a AppendFormat(String, Object) metody pro připojení malých řetězců.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Viz také

StringBuilder(String, Int32)

Inicializuje novou instanci třídy StringBuilder pomocí zadaného řetězce a kapacity.Initializes a new instance of the StringBuilder class using the specified string and capacity.

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)

Parametry

value
String

Řetězec použitý k inicializaci hodnoty instance.The string used to initialize the value of the instance. Pokud je value null, bude nový StringBuilder obsahovat prázdný řetězec (to znamená, že obsahuje Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

capacity
Int32

Navrhovaná počáteční velikost StringBuilder.The suggested starting size of the StringBuilder.

Výjimky

Hodnota capacity je menší než nula.capacity is less than zero.

Příklady

Následující příklad ukazuje, jak volat konstruktor StringBuilder s počátečním řetězcem a zadanou kapacitou.The following example demonstrates how to call the StringBuilder constructor with an initial string and a specified 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);
Dim initialString As String = "Initial string. "
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, capacity)

Poznámky

Parametr capacity definuje maximální počet znaků, které mohou být uloženy v paměti přidělené aktuální instancí.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Jeho hodnota je přiřazena vlastnosti Capacity.Its value is assigned to the Capacity property. Pokud počet znaků, které mají být uloženy v aktuální instanci, překračuje tuto capacity hodnotu, objekt StringBuilder přidělí další paměť pro jejich uložení.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Pokud je capacity nula, použije se výchozí kapacita specifická pro implementaci.If capacity is zero, the implementation-specific default capacity is used.

Viz také

StringBuilder(String, Int32, Int32, Int32)

Inicializuje novou instanci třídy StringBuilder ze zadaného podřetězce a kapacity.Initializes a new instance of the StringBuilder class from the specified substring and capacity.

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)

Parametry

value
String

Řetězec, který obsahuje podřetězec použitý k inicializaci hodnoty této instance.The string that contains the substring used to initialize the value of this instance. Pokud je value null, bude nový StringBuilder obsahovat prázdný řetězec (to znamená, že obsahuje Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

startIndex
Int32

Pozice v rámci value, kde začíná podřetězec.The position within value where the substring begins.

length
Int32

Počet znaků v podřetězci.The number of characters in the substring.

capacity
Int32

Navrhovaná počáteční velikost StringBuilder.The suggested starting size of the StringBuilder.

Výjimky

Hodnota capacity je menší než nula.capacity is less than zero.

-nebo--or-

startIndex plus length není pozice v rámci value.startIndex plus length is not a position within value.

Příklady

Následující příklad ukazuje, jak volat konstruktor StringBuilder se zadaným řetězcem.The following example demonstrates how to call the StringBuilder constructor with the specified string.

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

Poznámky

Parametr capacity definuje maximální počet znaků, které mohou být uloženy v paměti přidělené aktuální instancí.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Jeho hodnota je přiřazena vlastnosti Capacity.Its value is assigned to the Capacity property. Pokud počet znaků, které mají být uloženy v aktuální instanci, překračuje tuto capacity hodnotu, objekt StringBuilder přidělí další paměť pro jejich uložení.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Pokud je capacity nula, použije se výchozí kapacita specifická pro implementaci.If capacity is zero, the implementation-specific default capacity is used.

Viz také

Platí pro