StringBuilder Konstruktory

Odwołanie

Definicja

Przestrzeń nazw:: System.Text

Zestaw:: System.Runtime.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Inicjuje nowe wystąpienie klasy StringBuilder.

Przeciążenia

StringBuilder()	Inicjuje nowe wystąpienie klasy StringBuilder.
StringBuilder(Int32)	Inicjuje StringBuilder nowe wystąpienie klasy przy użyciu określonej pojemności.
StringBuilder(String)	Inicjuje StringBuilder nowe wystąpienie klasy przy użyciu określonego ciągu.
StringBuilder(Int32, Int32)	Inicjuje StringBuilder nowe wystąpienie klasy rozpoczynającej się od określonej pojemności i może wzrosnąć do określonej wartości maksymalnej.
StringBuilder(String, Int32)	Inicjuje StringBuilder nowe wystąpienie klasy przy użyciu określonego ciągu i pojemności.
StringBuilder(String, Int32, Int32, Int32)	Inicjuje StringBuilder nowe wystąpienie klasy z określonego podciągu i pojemności.

StringBuilder()

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inicjuje nowe wystąpienie klasy StringBuilder.

public:
 StringBuilder();

public StringBuilder ();

Public Sub New ()

Przykłady

W poniższym przykładzie pokazano, jak wywołać StringBuilder konstruktor bez parametrów.

StringBuilder^ stringBuilder = gcnew StringBuilder;

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

Uwagi

Wartość ciągu tego wystąpienia jest ustawiona na String.Empty, a pojemność jest ustawiona na pojemność domyślną specyficzną dla implementacji.

Dotyczy

StringBuilder(Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inicjuje StringBuilder nowe wystąpienie klasy przy użyciu określonej pojemności.

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

Sugerowany rozmiar początkowy tego wystąpienia.

Wyjątki

ArgumentOutOfRangeException

Parametr capacity ma wartość niższą niż zero.

Przykłady

W poniższym przykładzie pokazano, jak wywołać StringBuilder konstruktora o określonej pojemności.

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)

Uwagi

Parametr capacity definiuje maksymalną liczbę znaków, które mogą być przechowywane w pamięci przydzielonej przez bieżące wystąpienie. Jego wartość jest przypisywana Capacity do właściwości . Jeśli liczba znaków, które mają być przechowywane w bieżącym wystąpieniu, przekracza tę capacity wartość, StringBuilder obiekt przydziela dodatkową pamięć do ich przechowywania.

Wartość ciągu tego wystąpienia jest ustawiona na String.Emptywartość . Jeśli capacity wartość jest równa zero, zostanie użyta domyślna pojemność specyficzna dla implementacji.

Zobacz też

Capacity

Dotyczy

StringBuilder(String)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inicjuje StringBuilder nowe wystąpienie klasy przy użyciu określonego ciągu.

public:
 StringBuilder(System::String ^ value);

public StringBuilder (string value);

public StringBuilder (string? value);

new System.Text.StringBuilder : string -> System.Text.StringBuilder

Public Sub New (value As String)

Parametry

value: String

Ciąg używany do inicjowania wartości wystąpienia. Jeśli value parametr ma nullwartość , nowy StringBuilder będzie zawierać pusty ciąg (czyli zawiera Emptywartość ).

Przykłady

W poniższym przykładzie pokazano, jak wywołać StringBuilder konstruktora przy użyciu określonego ciągu.

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)

Uwagi

Jeśli value parametr ma nullwartość , nowy StringBuilder będzie zawierać pusty ciąg (czyli zawiera Emptywartość ).

Dotyczy

StringBuilder(Int32, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inicjuje StringBuilder nowe wystąpienie klasy rozpoczynającej się od określonej pojemności i może wzrosnąć do określonej wartości maksymalnej.

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

Sugerowany rozmiar początkowy elementu StringBuilder.

maxCapacity: Int32

Maksymalna liczba znaków, które może zawierać bieżący ciąg.

Wyjątki

ArgumentOutOfRangeException

maxCapacity jest mniejsza niż jedna, capacity jest mniejsza niż zero lub capacity jest większa niż maxCapacity.

Przykłady

W poniższym przykładzie pokazano, jak wywołać StringBuilder konstruktora z określoną pojemnością i maksymalną pojemnością.

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)

Uwagi

Jeśli capacity wartość jest równa zero, zostanie użyta domyślna pojemność specyficzna dla implementacji.

Właściwość maxCapacity definiuje maksymalną liczbę znaków, które może przechowywać bieżące wystąpienie. Jego wartość jest przypisywana MaxCapacity do właściwości . Jeśli liczba znaków, które mają być przechowywane w bieżącym wystąpieniu, przekracza tę maxCapacity wartość, StringBuilder obiekt nie przydziela dodatkowej pamięci, ale zamiast tego zgłasza wyjątek.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

StringBuilder(String, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inicjuje StringBuilder nowe wystąpienie klasy przy użyciu określonego ciągu i pojemności.

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.StringBuilder

Public Sub New (value As String, capacity As Integer)

Parametry

value: String

Ciąg używany do inicjowania wartości wystąpienia. Jeśli value parametr ma nullwartość , nowy StringBuilder będzie zawierać pusty ciąg (czyli zawiera Emptywartość ).

capacity: Int32

Sugerowany rozmiar początkowy elementu StringBuilder.

Wyjątki

ArgumentOutOfRangeException

Parametr capacity ma wartość niższą niż zero.

Przykłady

W poniższym przykładzie pokazano, jak wywołać konstruktor z StringBuilder początkowym ciągiem i określoną pojemnością.

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)

Uwagi

Jeśli capacity wartość jest równa zero, zostanie użyta domyślna pojemność specyficzna dla implementacji.

Zobacz też

Capacity

Dotyczy

StringBuilder(String, Int32, Int32, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inicjuje StringBuilder nowe wystąpienie klasy z określonego podciągu i pojemności.

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.StringBuilder

Public Sub New (value As String, startIndex As Integer, length As Integer, capacity As Integer)

Parametry

value: String

Ciąg zawierający podciąg używany do inicjowania wartości tego wystąpienia. Jeśli value parametr ma nullwartość , nowy StringBuilder będzie zawierać pusty ciąg (czyli zawiera Emptywartość ).

startIndex: Int32

Pozycja, w której value rozpoczyna się podciąg.

length: Int32

Liczba znaków w podciąg.

capacity: Int32

Sugerowany rozmiar początkowy elementu StringBuilder.

Wyjątki

ArgumentOutOfRangeException

Parametr capacity ma wartość niższą niż zero.

-lub-

startIndex plus length nie jest pozycją w obrębie value.

Przykłady

W poniższym przykładzie pokazano, jak wywołać StringBuilder konstruktora przy użyciu określonego ciągu.

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)

Uwagi

Jeśli capacity wartość jest równa zero, zostanie użyta domyślna pojemność specyficzna dla implementacji.

Zobacz też

Capacity

Dotyczy

StringBuilder Konstruktory

Definicja

Przeciążenia

StringBuilder()

Przykłady

Uwagi

Dotyczy

StringBuilder(Int32)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

StringBuilder(String)

Parametry

Przykłady

Uwagi

Dotyczy

StringBuilder(Int32, Int32)

Parametry

Wyjątki

Przykłady

Uwagi

Uwagi dotyczące wywoływania

Zobacz też

Dotyczy

StringBuilder(String, Int32)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

StringBuilder(String, Int32, Int32, Int32)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Opinia

Dodatkowe zasoby