StringBuilder Construtores

Referência

Definição

Namespace:: System.Text

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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

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

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

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

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

Aplica-se a

StringBuilder(String)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

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

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)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

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

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)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

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

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

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

Confira também

Capacity

Aplica-se a

StringBuilder(String, Int32, Int32, Int32)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

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

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

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

Confira também

Capacity

Aplica-se a

Partilhar via

StringBuilder Construtores

Definição

Sobrecargas

StringBuilder()

Exemplos

Comentários

Aplica-se a

StringBuilder(Int32)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

StringBuilder(String)

Parâmetros

Exemplos

Comentários

Aplica-se a

StringBuilder(Int32, Int32)

Parâmetros

Exceções

Exemplos

Comentários

Notas aos Chamadores

Confira também

Aplica-se a

StringBuilder(String, Int32)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

StringBuilder(String, Int32, Int32, Int32)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais