StringBuilder Konstruktory

Definice

Obor názvů:

System.Text

Sestavení:

System.Runtime.dll

Inicializuje novou instanci StringBuilder třídy .

Přetížení

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 narůstat 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ěžce 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 = gcnew StringBuilder;

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

Poznámky

Řetězcová hodnota této instance je nastavená na String.Emptya kapacita je nastavená 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 = 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)

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í. Jeho hodnota je přiřazena Capacity vlastnosti . Pokud počet znaků, které mají být uloženy v aktuální instanci překročí tuto capacity hodnotu, StringBuilder objekt přidělí další paměť k jejich uložení.

Řetězcová hodnota této instance je nastavená 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 je 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 = 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)

Poznámky

Pokud value je 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 narůstat 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 = 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)

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í. Jeho hodnota je přiřazena Capacity vlastnosti . Pokud počet znaků, které mají být uloženy v aktuální instanci překročí tuto capacity hodnotu, StringBuilder objekt přidělí další paměť k 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ů, které mají být uloženy v aktuální instanci překročí tuto maxCapacity hodnotu, 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 vytvoříte instanci StringBuilder objektu voláním konstruktoru StringBuilder(Int32, Int32) , délka i kapacita StringBuilder instance se mohou zvětšit nad hodnotu její MaxCapacity vlastnosti. K tomu může dojít zejména při volání Append(String) metod a AppendFormat(String, Object) 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 je 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 = 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)

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í. Jeho hodnota je přiřazena Capacity vlastnosti . Pokud počet znaků, které mají být uloženy v aktuální instanci překročí tuto capacity hodnotu, StringBuilder objekt přidělí další paměť k 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ěžce 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 použitý k inicializaci hodnoty této instance. Pokud value je null, nový StringBuilder bude obsahovat prázdný řetězec (to znamená , že obsahuje Empty).

startIndex

Int32

Pozice v rámci value místa, kde podřetězení začíná.

length

Int32

Počet znaků v podřetěžci.

capacity

Int32

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

Výjimky

ArgumentOutOfRangeException

Hodnota capacity je menší než nula.

-nebo-

startIndex plus length není pozice v rámci value.

Příklady

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

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)

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í. Jeho hodnota je přiřazena Capacity vlastnosti . Pokud počet znaků, které mají být uloženy v aktuální instanci překročí tuto capacity hodnotu, StringBuilder objekt přidělí další paměť k jejich uložení.

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

Viz také

• Capacity