StringBuilder Construtores

Definição

Namespace:

System.Text

Assembly:

System.Runtime.dll

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

Origem:

StringBuilder.cs

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.

StringBuilder(Int32)

Origem:

StringBuilder.cs

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

ArgumentOutOfRangeException

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

• Capacity

StringBuilder(String)

Origem:

StringBuilder.cs

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

public:
 StringBuilder(System::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).

StringBuilder(Int32, Int32)

Origem:

StringBuilder.cs

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

ArgumentOutOfRangeException

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

• Capacity
• MaxCapacity

StringBuilder(String, Int32)

Origem:

StringBuilder.cs

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

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

ArgumentOutOfRangeException

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

• Capacity

StringBuilder(String, Int32, Int32, Int32)

Origem:

StringBuilder.cs

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

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

ArgumentOutOfRangeException

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

• Capacity