StringBuilder Konstruktory

Definicja

Przestrzeń nazw:

System.Text

Zestawy:

netstandard.dll, System.Runtime.dll

Inicjuje nowe wystąpienie klasy StringBuilder.

Przeciążenia

Nazwa	Opis
StringBuilder()	Inicjuje nowe wystąpienie klasy StringBuilder.
StringBuilder(Int32)	Inicjuje nowe wystąpienie StringBuilder klasy przy użyciu określonej pojemności.
StringBuilder(String)	Inicjuje nowe wystąpienie StringBuilder klasy przy użyciu określonego ciągu.
StringBuilder(Int32, Int32)	Inicjuje nowe wystąpienie StringBuilder klasy rozpoczynającej się od określonej pojemności i może wzrosnąć do określonej wartości maksymalnej.
StringBuilder(String, Int32)	Inicjuje nowe wystąpienie StringBuilder klasy przy użyciu określonego ciągu i pojemności.
StringBuilder(String, Int32, Int32, Int32)	Inicjuje nowe wystąpienie StringBuilder 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 = 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 nowe wystąpienie StringBuilder 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 konstruktor z określoną pojemnością.

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 ma wartość zero, zostanie użyta pojemność domyślna specyficzna dla implementacji.

Zobacz też

• Capacity

StringBuilder(String)

Źródło:

StringBuilder.cs

Inicjuje nowe wystąpienie StringBuilder 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 to null, nowy StringBuilder będzie zawierać pusty ciąg (czyli zawiera Emptywartość ).

Przykłady

W poniższym przykładzie pokazano, jak wywołać StringBuilder konstruktor z określonym ciągiem.

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 to null, nowy StringBuilder będzie zawierać pusty ciąg (czyli zawiera Emptywartość ).

StringBuilder(Int32, Int32)

Źródło:

StringBuilder.cs

Inicjuje nowe wystąpienie StringBuilder 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 wartość 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 konstruktor z określoną pojemnością i maksymalną pojemnością.

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 ma wartość zero, zostanie użyta pojemność domyślna 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.

Notatki dotyczące wywoływania

W programie .NET Core i w wersjach .NET Framework 4.0 i nowszych 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 nowe wystąpienie StringBuilder 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 to null, 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 = "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 ma wartość zero, zostanie użyta pojemność domyślna specyficzna dla implementacji.

Zobacz też

• Capacity

StringBuilder(String, Int32, Int32, Int32)

Źródło:

StringBuilder.cs

Inicjuje nowe wystąpienie StringBuilder 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 to null, nowy StringBuilder będzie zawierać pusty ciąg (czyli zawiera Emptywartość ).

startIndex

Int32

Położenie w miejscu, w value którym rozpoczyna się podciąg.

length

Int32

Liczba znaków w podciągnie.

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 konstruktor z określonym ciągiem.

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 ma wartość zero, zostanie użyta pojemność domyślna specyficzna dla implementacji.

Zobacz też

• Capacity