StringBuilder StringBuilder StringBuilder StringBuilder Constructors

Definição

Sobrecargas

StringBuilder() StringBuilder() StringBuilder()

Inicializa uma nova instância da classe StringBuilder.Initializes a new instance of the StringBuilder class.

StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32)

Inicializa uma nova instância da classe StringBuilder usando a capacidade especificada.Initializes a new instance of the StringBuilder class using the specified capacity.

StringBuilder(String) StringBuilder(String) StringBuilder(String) StringBuilder(String)

Inicializa uma nova instância da classe StringBuilder usando a cadeia de caracteres especificada.Initializes a new instance of the StringBuilder class using the specified string.

StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) 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.Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32)

Inicializa uma nova instância da classe StringBuilder usando a cadeia de caracteres e a capacidade especificadas.Initializes a new instance of the StringBuilder class using the specified string and capacity.

StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32)

Inicializa uma nova instância da classe StringBuilder da capacidade e da subcadeia de caracteres especificada.Initializes a new instance of the StringBuilder class from the specified substring and capacity.

StringBuilder() StringBuilder() StringBuilder()

Inicializa uma nova instância da classe StringBuilder.Initializes a new instance of the StringBuilder class.

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

Exemplos

O exemplo a seguir demonstra como chamar o StringBuilder Construtor sem parâmetros.The following example demonstrates how to call the StringBuilder constructor with no parameters.

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

Comentários

O valor da cadeia de caracteres dessa instância é String.Emptydefinido como, e a capacidade é definida como a capacidade padrão específica da implementação.The string value of this instance is set to String.Empty, and the capacity is set to the implementation-specific default capacity.

StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32)

Inicializa uma nova instância da classe StringBuilder usando a capacidade especificada.Initializes a new instance of the StringBuilder class using the specified capacity.

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 Int32 Int32 Int32

O tamanho inicial sugerido desta instância.The suggested starting size of this instance.

Exceções

Exemplos

O exemplo a seguir demonstra como chamar o StringBuilder Construtor com uma capacidade especificada.The following example demonstrates how to call the StringBuilder constructor with a specified capacity.

int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity );
int capacity = 255;
StringBuilder stringBuilder = new 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.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Seu valor é atribuído à Capacity propriedade.Its value is assigned to the Capacity property. 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.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

O valor da cadeia de caracteres dessa instância é String.Emptydefinido como.The string value of this instance is set to String.Empty. Se capacity for zero, a capacidade padrão específica da implementação será usada.If capacity is zero, the implementation-specific default capacity is used.

Veja também

StringBuilder(String) StringBuilder(String) StringBuilder(String) StringBuilder(String)

Inicializa uma nova instância da classe StringBuilder usando a cadeia de caracteres especificada.Initializes a new instance of the StringBuilder class using the specified string.

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 String String String

A cadeia de caracteres usada para inicializar o valor da instância.The string used to initialize the value of the instance. Se value for null, o novo StringBuilder conterá a cadeia de caracteres vazia (ou seja, ele conterá Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

Exemplos

O exemplo a seguir demonstra como chamar o StringBuilder Construtor com a cadeia de caracteres especificada.The following example demonstrates how to call the StringBuilder constructor with the specified string.

String^ initialString = L"Initial string.";
StringBuilder^ stringBuilder = gcnew StringBuilder( initialString );
string initialString = "Initial string.";
StringBuilder stringBuilder = new 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).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) 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.Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

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 Int32 Int32 Int32

O tamanho inicial sugerido de StringBuilder.The suggested starting size of the StringBuilder.

maxCapacity
Int32 Int32 Int32 Int32

O número máximo de caracteres que a cadeia de caracteres atual pode conter.The maximum number of characters the current string can contain.

Exceções

maxCapacity é menor que 1, capacity é menor que zero ou capacity é maior que maxCapacity.maxCapacity is less than one, capacity is less than zero, or capacity is greater than maxCapacity.

Exemplos

O exemplo a seguir demonstra como chamar o StringBuilder Construtor com uma capacidade especificada e a capacidade máxima.The following example demonstrates how to call the StringBuilder constructor with a specified capacity and maximum capacity.

int capacity = 255;
int maxCapacity = 1024;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity,maxCapacity );
int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new 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.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Seu valor é atribuído à Capacity propriedade.Its value is assigned to the Capacity property. 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.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Se capacity for zero, a capacidade padrão específica da implementação será usada.If capacity is zero, the implementation-specific default capacity is used.

A maxCapacity propriedade define o número máximo de caracteres que a instância atual pode conter.The maxCapacity property defines the maximum number of characters that the current instance can hold. Seu valor é atribuído à MaxCapacity propriedade.Its value is assigned to the MaxCapacity property. Se o número de caracteres a serem armazenados na instância atual exceder esse maxCapacity valor, o StringBuilder objeto não aloca memória adicional, mas, em vez disso, gera uma exceção.If the number of characters to be stored in the current instance exceeds this maxCapacity value, the StringBuilder object does not allocate additional memory, but instead throws an exception.

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, o comprimento StringBuilder e a capacidade da instância podem crescer além do valor de sua MaxCapacity Propriedade.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Isso pode ocorrer especialmente quando você chama os Append(String) métodos AppendFormat(String, Object) e para acrescentar cadeias de caracteres pequenas.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Veja também

StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32)

Inicializa uma nova instância da classe StringBuilder usando a cadeia de caracteres e a capacidade especificadas.Initializes a new instance of the StringBuilder class using the specified string and capacity.

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 String String String

A cadeia de caracteres usada para inicializar o valor da instância.The string used to initialize the value of the instance. Se value for null, o novo StringBuilder conterá a cadeia de caracteres vazia (ou seja, ele conterá Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

capacity
Int32 Int32 Int32 Int32

O tamanho inicial sugerido de StringBuilder.The suggested starting size of the StringBuilder.

Exceções

Exemplos

O exemplo a seguir demonstra como chamar o StringBuilder Construtor com uma cadeia de caracteres inicial e uma capacidade especificada.The following example demonstrates how to call the StringBuilder constructor with an initial string and a specified capacity.

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);
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.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Seu valor é atribuído à Capacity propriedade.Its value is assigned to the Capacity property. 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.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Se capacity for zero, a capacidade padrão específica da implementação será usada.If capacity is zero, the implementation-specific default capacity is used.

Veja também

StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32)

Inicializa uma nova instância da classe StringBuilder da capacidade e da subcadeia de caracteres especificada.Initializes a new instance of the StringBuilder class from the specified substring and capacity.

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 String String String

A cadeia de caracteres que contém a subcadeia de caracteres usada para inicializar o valor dessa instância.The string that contains the substring used to initialize the value of this instance. Se value for null, o novo StringBuilder conterá a cadeia de caracteres vazia (ou seja, ele conterá Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

startIndex
Int32 Int32 Int32 Int32

A posição dentro de value na qual a subcadeia de caracteres começa.The position within value where the substring begins.

length
Int32 Int32 Int32 Int32

O número de caracteres na subcadeia de caracteres.The number of characters in the substring.

capacity
Int32 Int32 Int32 Int32

O tamanho inicial sugerido de StringBuilder.The suggested starting size of the StringBuilder.

Exceções

capacity é menor que zero.capacity is less than zero.

- ou --or- startIndex além de length não é uma posição no value.startIndex plus length is not a position within value.

Exemplos

O exemplo a seguir demonstra como chamar o StringBuilder Construtor com a cadeia de caracteres especificada.The following example demonstrates how to call the StringBuilder constructor with the specified string.

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);
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.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Seu valor é atribuído à Capacity propriedade.Its value is assigned to the Capacity property. 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.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Se capacity for zero, a capacidade padrão específica da implementação será usada.If capacity is zero, the implementation-specific default capacity is used.

Veja também

Aplica-se a