StringBuilder Konstruktory

Definicja

Przestrzeń nazw:

System.Text

Zestaw:

System.Runtime.dll

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

Źródło:

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.

StringBuilder(Int32)

Źródło:

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

StringBuilder(String)

Źródło:

StringBuilder.cs

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

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

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ść ).

StringBuilder(Int32, Int32)

Źródło:

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

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.

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ż

• Capacity
• MaxCapacity

StringBuilder(String, Int32)

Źródło:

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

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

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.

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

Zobacz też

• Capacity

StringBuilder(String, Int32, Int32, Int32)

Źródło:

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

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

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.

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

Zobacz też

• Capacity