StringBuilder Construtores

Definição

Espaço de Nomes:: System.Text

Assemblagens:: mscorlib.dll, System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da StringBuilder classe.

Sobrecargas

Name	Description
StringBuilder()	Inicializa uma nova instância da StringBuilder classe.
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 especificada.
StringBuilder(Int32, Int32)	Inicializa uma nova instância da StringBuilder classe que começa com uma capacidade especificada e pode crescer até um máximo especificado.
StringBuilder(String, Int32)	Inicializa uma nova instância da StringBuilder classe usando a cadeia e capacidade especificadas.
StringBuilder(String, Int32, Int32, Int32)	Inicializa uma nova instância da StringBuilder classe a partir da substring e capacidade especificadas.

StringBuilder()

Inicializa uma nova instância da StringBuilder classe.

public:
 StringBuilder();

public StringBuilder();

Public Sub New ()

Exemplos

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

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

Observações

O valor da cadeia desta instância é definido para String.Empty, e a capacidade é definida para a capacidade padrão específica da implementação.

Aplica-se a

StringBuilder(Int32)

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.StringBuilder

Public Sub New (capacity As Integer)

Parâmetros

capacity: Int32

O tamanho inicial sugerido desta instância.

Exceções

ArgumentOutOfRangeException

capacity é inferior a zero.

Exemplos

O exemplo seguinte 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)

Observações

O capacity parâmetro define o número máximo de caracteres que podem ser armazenados na memória alocada pela instância atual. O seu valor é atribuído à Capacity propriedade. Se o número de caracteres a armazenar na instância atual exceder este capacity valor, o StringBuilder objeto aloca memória adicional para os armazenar.

O valor da cadeia desta instância é definido para String.Empty. Se capacity for zero, utiliza-se a capacidade padrão específica da implementação.

Ver também

Capacity

Aplica-se a

StringBuilder(String)

Inicializa uma nova instância da StringBuilder classe usando a cadeia 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 usada para inicializar o valor da instância. Se value for null, o novo StringBuilder conterá a cadeia vazia (ou seja, contém Empty).

Exemplos

O exemplo seguinte demonstra como chamar o StringBuilder construtor com a cadeia 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)

Observações

Se value for null, o novo StringBuilder conterá a cadeia vazia (ou seja, contém Empty).

Aplica-se a

StringBuilder(Int32, Int32)

Inicializa uma nova instância da StringBuilder classe 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 do StringBuilder.

maxCapacity: Int32

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

Exceções

ArgumentOutOfRangeException

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

Exemplos

O exemplo seguinte demonstra como chamar o StringBuilder construtor com uma capacidade e capacidade máxima especificadas.

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)

Observações

Se capacity for zero, utiliza-se a capacidade padrão específica da implementação.

A maxCapacity propriedade define o número máximo de caracteres que a instância atual pode conter. O seu valor é atribuído à MaxCapacity propriedade. Se o número de caracteres a armazenar na instância atual exceder este maxCapacity valor, o StringBuilder objeto não aloca memória adicional, mas sim lança uma exceção.

Notas para Chamadores

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

Ver também

Aplica-se a

StringBuilder(String, Int32)

Inicializa uma nova instância da StringBuilder classe usando a cadeia e 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 usada para inicializar o valor da instância. Se value for null, o novo StringBuilder conterá a cadeia vazia (ou seja, contém Empty).

capacity: Int32

O tamanho inicial sugerido do StringBuilder.

Exceções

ArgumentOutOfRangeException

capacity é inferior a zero.

Exemplos

O exemplo seguinte demonstra como chamar o StringBuilder construtor com uma cadeia 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)

Observações

Se capacity for zero, utiliza-se a capacidade padrão específica da implementação.

Ver também

Capacity

Aplica-se a

StringBuilder(String, Int32, Int32, Int32)

Inicializa uma nova instância da StringBuilder classe a partir da substring e capacidade especificadas.

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 que contém a subcadeia usada para inicializar o valor desta instância. Se value for null, o novo StringBuilder conterá a cadeia vazia (ou seja, contém Empty).

startIndex: Int32

A posição dentro value de onde a subcadeia começa.

length: Int32

O número de caracteres na substring.

capacity: Int32

O tamanho inicial sugerido do StringBuilder.

Exceções

ArgumentOutOfRangeException

capacity é inferior a zero.

-ou-

startIndex Plus length não é uma posição dentro valuede .

Exemplos

O exemplo seguinte demonstra como chamar o StringBuilder construtor com a cadeia 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)

Observações

Se capacity for zero, utiliza-se a capacidade padrão específica da implementação.

Ver também

Capacity

Aplica-se a

Comentários

Esta página foi útil?