StringBuilder Construtores

Definição

Inicializa uma nova instância da classe StringBuilder.

Sobrecargas

StringBuilder()

Inicializa uma nova instância da classe StringBuilder.

StringBuilder(Int32)

Inicializa uma nova instância da classe StringBuilder usando a capacidade especificada.

StringBuilder(String)

Inicializa uma nova instância da classe StringBuilder usando a cadeia de caracteres especificada.

StringBuilder(Int32, Int32)

Inicializa uma nova instância da classe StringBuilder que começa com uma capacidade especificada e pode crescer até um máximo especificado.

StringBuilder(String, Int32)

Inicializa uma nova instância da classe StringBuilder usando a cadeia de caracteres e a capacidade especificadas.

StringBuilder(String, Int32, Int32, Int32)

Inicializa uma nova instância da classe StringBuilder da capacidade e da subcadeia de caracteres especificada.

StringBuilder()

Inicializa uma nova instância da classe StringBuilder.

public:
 StringBuilder();
public StringBuilder ();
Public Sub New ()

Exemplos

O exemplo a seguir demonstra como chamar o StringBuilder construtor sem parâmetros.

StringBuilder^ stringBuilder = gcnew StringBuilder;
StringBuilder stringBuilder = new StringBuilder();
let stringBuilder = StringBuilder()
Dim stringBuilder As New StringBuilder

Comentários

O valor da cadeia de caracteres dessa instância é definido como String.Emptye a capacidade é definida como a capacidade padrão específica da implementação.

Aplica-se a

StringBuilder(Int32)

Inicializa uma nova instância da classe StringBuilder usando a capacidade especificada.

public:
 StringBuilder(int capacity);
public StringBuilder (int capacity);
new System.Text.StringBuilder : int -> System.Text.StringBuilder
Public Sub New (capacity As Integer)

Parâmetros

capacity
Int32

O tamanho inicial sugerido desta instância.

Exceções

capacity é menor que zero.

Exemplos

O exemplo a seguir demonstra como chamar o StringBuilder construtor com uma capacidade especificada.

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)

Comentários

O capacity parâmetro define o número máximo de caracteres que podem ser armazenados na memória alocada pela instância atual. Seu valor é atribuído à Capacity propriedade . Se o número de caracteres a serem armazenados na instância atual exceder esse capacity valor, o StringBuilder objeto alocará memória adicional para armazená-los.

O valor da cadeia de caracteres dessa instância é definido como String.Empty. Se capacity for zero, a capacidade padrão específica da implementação será usada.

Confira também

Aplica-se a

StringBuilder(String)

Inicializa uma nova instância da classe StringBuilder usando a cadeia de caracteres especificada.

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)

Parâmetros

value
String

A cadeia de caracteres usada para inicializar o valor da instância. Se value for null, o novo StringBuilder conterá a cadeia de caracteres vazia (ou seja, ele conterá Empty).

Exemplos

O exemplo a seguir demonstra como chamar o StringBuilder construtor com a cadeia de caracteres especificada.

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)

Comentários

Se value for null, o novo StringBuilder conterá a cadeia de caracteres vazia (ou seja, ele conterá Empty).

Aplica-se a

StringBuilder(Int32, Int32)

Inicializa uma nova instância da classe StringBuilder que começa com uma capacidade especificada e pode crescer até um máximo especificado.

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)

Parâmetros

capacity
Int32

O tamanho inicial sugerido de StringBuilder.

maxCapacity
Int32

O número máximo de caracteres que a cadeia de caracteres atual pode conter.

Exceções

maxCapacity é menor que 1, capacity é menor que zero ou capacity é maior que maxCapacity.

Exemplos

O exemplo a seguir demonstra como chamar o StringBuilder construtor com uma capacidade especificada e capacidade máxima.

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)

Comentários

O capacity parâmetro define o número máximo de caracteres que podem ser armazenados na memória alocada pela instância atual. Seu valor é atribuído à Capacity propriedade . Se o número de caracteres a serem armazenados na instância atual exceder esse capacity valor, o StringBuilder objeto alocará memória adicional para armazená-los.

Se capacity for zero, a capacidade padrão específica da implementação será usada.

A maxCapacity propriedade define o número máximo de caracteres que a instância atual pode conter. Seu valor é atribuído à MaxCapacity propriedade . Se o número de caracteres a serem armazenados na instância atual exceder esse maxCapacity valor, o StringBuilder objeto não alocará memória adicional, mas gerará uma exceção.

Notas aos Chamadores

No .NET Core e no .NET Framework 4.0 e versões posteriores, quando você instancia o StringBuilder objeto chamando o StringBuilder(Int32, Int32) construtor, tanto o comprimento quanto a capacidade da StringBuilder instância podem crescer além do valor de sua MaxCapacity propriedade. Isso pode ocorrer especialmente quando você chama os Append(String) métodos e AppendFormat(String, Object) para acrescentar cadeias de caracteres pequenas.

Confira também

Aplica-se a

StringBuilder(String, Int32)

Inicializa uma nova instância da classe StringBuilder usando a cadeia de caracteres e a capacidade especificadas.

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)

Parâmetros

value
String

A cadeia de caracteres usada para inicializar o valor da instância. Se value for null, o novo StringBuilder conterá a cadeia de caracteres vazia (ou seja, ele conterá Empty).

capacity
Int32

O tamanho inicial sugerido de StringBuilder.

Exceções

capacity é menor que zero.

Exemplos

O exemplo a seguir demonstra como chamar o StringBuilder construtor com uma cadeia de caracteres inicial e uma capacidade especificada.

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)

Comentários

O capacity parâmetro define o número máximo de caracteres que podem ser armazenados na memória alocada pela instância atual. Seu valor é atribuído à Capacity propriedade . Se o número de caracteres a serem armazenados na instância atual exceder esse capacity valor, o StringBuilder objeto alocará memória adicional para armazená-los.

Se capacity for zero, a capacidade padrão específica da implementação será usada.

Confira também

Aplica-se a

StringBuilder(String, Int32, Int32, Int32)

Inicializa uma nova instância da classe StringBuilder da capacidade e da subcadeia de caracteres especificada.

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)

Parâmetros

value
String

A cadeia de caracteres que contém a subcadeia de caracteres usada para inicializar o valor dessa instância. Se value for null, o novo StringBuilder conterá a cadeia de caracteres vazia (ou seja, ele conterá Empty).

startIndex
Int32

A posição dentro de value na qual a subcadeia de caracteres começa.

length
Int32

O número de caracteres na subcadeia de caracteres.

capacity
Int32

O tamanho inicial sugerido de StringBuilder.

Exceções

capacity é menor que zero.

- ou -

startIndex além de length não é uma posição no value.

Exemplos

O exemplo a seguir demonstra como chamar o StringBuilder construtor com a cadeia de caracteres especificada.

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)

Comentários

O capacity parâmetro define o número máximo de caracteres que podem ser armazenados na memória alocada pela instância atual. Seu valor é atribuído à Capacity propriedade . Se o número de caracteres a serem armazenados na instância atual exceder esse capacity valor, o StringBuilder objeto alocará memória adicional para armazená-los.

Se capacity for zero, a capacidade padrão específica da implementação será usada.

Confira também

Aplica-se a