StringBuilder Konstruktory

Definice

Obor názvů:

System.Text

Sestavení:

netstandard.dll, System.Runtime.dll

Inicializuje novou instanci StringBuilder třídy.

Přetížení

Name	Description
StringBuilder()	Inicializuje novou instanci StringBuilder třídy.
StringBuilder(Int32)	Inicializuje novou instanci StringBuilder třídy pomocí zadané kapacity.
StringBuilder(String)	Inicializuje novou instanci StringBuilder třídy pomocí zadaného řetězce.
StringBuilder(Int32, Int32)	Inicializuje novou instanci StringBuilder třídy, která začíná zadanou kapacitou a může růst na zadané maximum.
StringBuilder(String, Int32)	Inicializuje novou instanci StringBuilder třídy pomocí zadaného řetězce a kapacity.
StringBuilder(String, Int32, Int32, Int32)	Inicializuje novou instanci StringBuilder třídy ze zadaného podřetědce a kapacity.

StringBuilder()

Zdroj:

StringBuilder.cs

Inicializuje novou instanci StringBuilder třídy.

public:
 StringBuilder();

public StringBuilder();

Public Sub New ()

Příklady

Následující příklad ukazuje, jak volat StringBuilder konstruktor bez parametrů.

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

Poznámky

Řetězcová hodnota této instance je nastavena na String.Emptyhodnotu a kapacita je nastavena na výchozí kapacitu specifickou pro implementaci.

StringBuilder(Int32)

Zdroj:

StringBuilder.cs

Inicializuje novou instanci StringBuilder třídy pomocí zadané kapacity.

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.

Výjimky

ArgumentOutOfRangeException

Hodnota capacity je menší než nula.

Příklady

Následující příklad ukazuje, jak volat StringBuilder konstruktor se zadanou kapacitou.

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)

Poznámky

Parametr capacity definuje maximální počet znaků, které lze uložit v paměti přidělené aktuální instancí. Jeho hodnota je přiřazena Capacity vlastnosti. Pokud počet znaků, které mají být uloženy v aktuální instanci překračuje tuto capacity hodnotu, StringBuilder objekt přidělí další paměť pro jejich uložení.

Hodnota řetězce této instance je nastavena na String.Empty. Pokud capacity je nula, použije se výchozí kapacita specifická pro implementaci.

Viz také

• Capacity

StringBuilder(String)

Zdroj:

StringBuilder.cs

Inicializuje novou instanci StringBuilder třídy pomocí zadaného řetězce.

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. Pokud value ano null, nový StringBuilder bude obsahovat prázdný řetězec (to znamená, že obsahuje Empty).

Příklady

Následující příklad ukazuje, jak volat StringBuilder konstruktor se zadaným řetězcem.

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)

Poznámky

Pokud value ano null, nový StringBuilder bude obsahovat prázdný řetězec (to znamená, že obsahuje Empty).

StringBuilder(Int32, Int32)

Zdroj:

StringBuilder.cs

Inicializuje novou instanci StringBuilder třídy, která začíná zadanou kapacitou a může růst na zadané 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.

maxCapacity

Int32

Maximální počet znaků, které může aktuální řetězec obsahovat.

Výjimky

ArgumentOutOfRangeException

maxCapacity je menší než jedna, capacity je menší než nula nebo capacity je větší než maxCapacity.

Příklady

Následující příklad ukazuje, jak volat StringBuilder konstruktor se zadanou kapacitou a maximální kapacitou.

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)

Poznámky

Parametr capacity definuje maximální počet znaků, které lze uložit v paměti přidělené aktuální instancí. Jeho hodnota je přiřazena Capacity vlastnosti. Pokud počet znaků, které mají být uloženy v aktuální instanci překračuje tuto capacity hodnotu, StringBuilder objekt přidělí další paměť pro jejich uložení.

Pokud capacity je nula, použije se výchozí kapacita specifická pro implementaci.

Vlastnost maxCapacity definuje maximální počet znaků, které může aktuální instance obsahovat. Jeho hodnota je přiřazena MaxCapacity vlastnosti. Pokud počet znaků uložených v aktuální instanci tuto hodnotu překročí maxCapacity , StringBuilder objekt nepřidělí další paměť, ale vyvolá výjimku.

Poznámky pro volající

V .NET Core a v rozhraní .NET Framework 4.0 a novějších verzích při vytváření instance StringBuilder objektu voláním StringBuilder(Int32, Int32) konstruktoru může délka i kapacita StringBuilder instance růst nad hodnotu jeho MaxCapacity vlastnosti. K tomu může dojít zejména při volání Append(String) a AppendFormat(String, Object) metod pro připojení malých řetězců.

Viz také

• Capacity
• MaxCapacity

StringBuilder(String, Int32)

Zdroj:

StringBuilder.cs

Inicializuje novou instanci StringBuilder třídy pomocí zadaného řetězce a kapacity.

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. Pokud value ano null, nový StringBuilder bude obsahovat prázdný řetězec (to znamená, že obsahuje Empty).

capacity

Int32

Navrhovaná počáteční velikost StringBuilder.

Výjimky

ArgumentOutOfRangeException

Hodnota capacity je menší než nula.

Příklady

Následující příklad ukazuje, jak volat StringBuilder konstruktor s počátečním řetězcem a zadanou kapacitou.

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)

Poznámky

Parametr capacity definuje maximální počet znaků, které lze uložit v paměti přidělené aktuální instancí. Jeho hodnota je přiřazena Capacity vlastnosti. Pokud počet znaků, které mají být uloženy v aktuální instanci překračuje tuto capacity hodnotu, StringBuilder objekt přidělí další paměť pro jejich uložení.

Pokud capacity je nula, použije se výchozí kapacita specifická pro implementaci.

Viz také

• Capacity

StringBuilder(String, Int32, Int32, Int32)

Zdroj:

StringBuilder.cs

Inicializuje novou instanci StringBuilder třídy ze zadaného podřetědce a kapacity.

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ězce sloužící k inicializaci hodnoty této instance. Pokud value ano null, nový StringBuilder bude obsahovat prázdný řetězec (to znamená, že obsahuje Empty).

startIndex

Int32

Pozice, ve value které začíná podřetětěr.

length

Int32

Počet znaků v podřetědci.

capacity

Int32

Navrhovaná počáteční velikost StringBuilder.

Výjimky

ArgumentOutOfRangeException

Hodnota capacity je menší než nula.

nebo

startIndex plus length není pozice uvnitř value.

Příklady

Následující příklad ukazuje, jak volat StringBuilder konstruktor se zadaným řetězcem.

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)

Poznámky

Parametr capacity definuje maximální počet znaků, které lze uložit v paměti přidělené aktuální instancí. Jeho hodnota je přiřazena Capacity vlastnosti. Pokud počet znaků, které mají být uloženy v aktuální instanci překračuje tuto capacity hodnotu, StringBuilder objekt přidělí další paměť pro jejich uložení.

Pokud capacity je nula, použije se výchozí kapacita specifická pro implementaci.

Viz také

• Capacity