StringBuilder Konstruktory
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
- Zdroj:
- StringBuilder.cs
- 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.
Platí pro
StringBuilder(Int32)
- Zdroj:
- StringBuilder.cs
- Zdroj:
- StringBuilder.cs
- 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.StringBuilderPublic Sub New (capacity As Integer)Parametry
- capacity
- Int32
Navrhovaná počáteční velikost této instance.
Výjimky
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é
Platí pro
StringBuilder(String)
- Zdroj:
- StringBuilder.cs
- Zdroj:
- StringBuilder.cs
- Zdroj:
- StringBuilder.cs
Inicializuje novou instanci StringBuilder třídy pomocí zadaného řetězce.
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)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).
Platí pro
StringBuilder(Int32, Int32)
- Zdroj:
- StringBuilder.cs
- Zdroj:
- StringBuilder.cs
- 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.StringBuilderPublic 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
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é
Platí pro
StringBuilder(String, Int32)
- Zdroj:
- StringBuilder.cs
- Zdroj:
- StringBuilder.cs
- 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);public StringBuilder (string? value, int capacity);new System.Text.StringBuilder : string * int -> System.Text.StringBuilderPublic 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
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é
Platí pro
StringBuilder(String, Int32, Int32, Int32)
- Zdroj:
- StringBuilder.cs
- Zdroj:
- StringBuilder.cs
- 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);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)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
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é
Platí pro
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro