StringBuilder Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe StringBuilder.
Sobrecargas
| Nome | Description |
|---|---|
| StringBuilder() |
Inicializa uma nova instância da classe StringBuilder. |
| StringBuilder(Int32) |
Inicializa uma nova instância da StringBuilder classe usando a capacidade especificada. |
| StringBuilder(String) |
Inicializa uma nova instância da StringBuilder classe usando a cadeia de caracteres especificada. |
| StringBuilder(Int32, Int32) |
Inicializa uma nova instância da StringBuilder classe que começa com uma capacidade especificada e pode aumentar para um máximo especificado. |
| StringBuilder(String, Int32) |
Inicializa uma nova instância da StringBuilder classe usando a cadeia de caracteres e a capacidade especificadas. |
| StringBuilder(String, Int32, Int32, Int32) |
Inicializa uma nova instância da classe da StringBuilder subcadeia de caracteres e capacidade especificada. |
StringBuilder()
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- 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 = new StringBuilder();
let stringBuilder = StringBuilder()
Dim stringBuilder As New StringBuilder
Comentários
O valor da cadeia de caracteres dessa instância é definido String.Emptycomo , e a capacidade é definida como a capacidade padrão específica da implementação.
Aplica-se a
StringBuilder(Int32)
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
Inicializa uma nova instância da StringBuilder classe usando a capacidade especificada.
public:
StringBuilder(int capacity);public StringBuilder(int capacity);new System.Text.StringBuilder : int -> System.Text.StringBuilderPublic Sub New (capacity As Integer)Parâmetros
- capacity
- Int32
O tamanho inicial sugerido dessa 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 = 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 à implementação será usada.
Confira também
Aplica-se a
StringBuilder(String)
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
Inicializa uma nova instância da StringBuilder classe 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.StringBuilderPublic 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, ela contém Empty).
Exemplos
O exemplo a seguir demonstra como chamar o StringBuilder construtor com a cadeia de caracteres especificada.
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, ela contém Empty).
Aplica-se a
StringBuilder(Int32, Int32)
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
Inicializa uma nova instância da StringBuilder classe que começa com uma capacidade especificada e pode aumentar para um máximo especificado.
public:
StringBuilder(int capacity, int maxCapacity);public StringBuilder(int capacity, int maxCapacity);new System.Text.StringBuilder : int * int -> System.Text.StringBuilderPublic Sub New (capacity As Integer, maxCapacity As Integer)Parâmetros
- capacity
- Int32
O tamanho inicial sugerido do StringBuilder.
- maxCapacity
- Int32
O número máximo de caracteres que a cadeia de caracteres atual pode conter.
Exceções
maxCapacity é menor que um, 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 =
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 à 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 e Append(String)AppendFormat(String, Object) os métodos para acrescentar cadeias de caracteres pequenas.
Confira também
Aplica-se a
StringBuilder(String, Int32)
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
Inicializa uma nova instância da StringBuilder classe 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.StringBuilderPublic 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, ela contém Empty).
- capacity
- Int32
O tamanho inicial sugerido do 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 = "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 à implementação será usada.
Confira também
Aplica-se a
StringBuilder(String, Int32, Int32, Int32)
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
- Origem:
- StringBuilder.cs
Inicializa uma nova instância da classe da StringBuilder subcadeia de caracteres e capacidade 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.StringBuilderPublic 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, ela contém Empty).
- startIndex
- Int32
A posição dentro value de onde a subcadeia de caracteres começa.
- length
- Int32
O número de carateres na subcadeia.
- capacity
- Int32
O tamanho inicial sugerido do StringBuilder.
Exceções
capacity é menor que zero.
- ou -
startIndex plus length não é uma posição dentro value.
Exemplos
O exemplo a seguir demonstra como chamar o StringBuilder construtor com a cadeia de caracteres especificada.
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 à implementação será usada.
