StringBuilder.Append StringBuilder.Append StringBuilder.Append StringBuilder.Append Method

Definição

Acrescenta a representação de cadeia de caracteres de um objeto especificado à essa instância.Appends the string representation of a specified object to this instance.

Sobrecargas

Append(StringBuilder) Append(StringBuilder) Append(StringBuilder) Append(StringBuilder)

Acrescenta a representação de cadeia de caracteres de um construtor de cadeia de caracteres especificado a essa instância.Appends the string representation of a specified string builder to this instance.

Append(UInt16) Append(UInt16) Append(UInt16) Append(UInt16)

Acrescenta a representação de cadeia de caracteres de um inteiro sem sinal de 16 bits especificado a essa instância.Appends the string representation of a specified 16-bit unsigned integer to this instance.

Append(UInt32) Append(UInt32) Append(UInt32) Append(UInt32)

Acrescenta a representação de cadeia de caracteres de um inteiro sem sinal de 32 bits especificado a essa instância.Appends the string representation of a specified 32-bit unsigned integer to this instance.

Append(UInt64) Append(UInt64) Append(UInt64) Append(UInt64)

Acrescenta a representação de cadeia de caracteres de um inteiro sem sinal de 64 bits especificado a essa instância.Appends the string representation of a specified 64-bit unsigned integer to this instance.

Append(Char[], Int32, Int32) Append(Char[], Int32, Int32) Append(Char[], Int32, Int32) Append(Char[], Int32, Int32)

Acrescenta a representação de cadeia de caracteres de uma submatriz especificada de caracteres Unicode à essa instância.Appends the string representation of a specified subarray of Unicode characters to this instance.

Append(Char*, Int32) Append(Char*, Int32) Append(Char*, Int32)

Acrescenta uma matriz de caracteres Unicode começando em um endereço especificado a essa instância.Appends an array of Unicode characters starting at a specified address to this instance.

Append(String) Append(String) Append(String) Append(String)

Acrescenta uma cópia da cadeia de caracteres especificada a essa instância.Appends a copy of the specified string to this instance.

Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32)

Acrescenta uma cópia de uma subcadeia de caracteres especificada a esta instância.Appends a copy of a specified substring to this instance.

Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32)

Acrescenta uma cópia de uma substring em um construtor de cadeia de caracteres especificado a essa instância.Appends a copy of a substring within a specified string builder to this instance.

Append(Char, Int32) Append(Char, Int32) Append(Char, Int32) Append(Char, Int32)

Acrescenta um número de cópias especificado da representação de cadeia de caracteres de um caractere Unicode a essa instância.Appends a specified number of copies of the string representation of a Unicode character to this instance.

Append(SByte) Append(SByte) Append(SByte) Append(SByte)

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 8 bits especificado a essa instância.Appends the string representation of a specified 8-bit signed integer to this instance.

Append(Single) Append(Single) Append(Single) Append(Single)

Acrescenta a representação de cadeia de caracteres de um número de ponto flutuante de precisão simples especificado a essa instância.Appends the string representation of a specified single-precision floating-point number to this instance.

Append(ReadOnlyMemory<Char>) Append(ReadOnlyMemory<Char>) Append(ReadOnlyMemory<Char>) Append(ReadOnlyMemory<Char>)

Acrescenta a representação de cadeia de caracteres de uma região de memória do caractere somente leitura a essa instância.Appends the string representation of a specified read-only character memory region to this instance.

Append(Boolean) Append(Boolean) Append(Boolean) Append(Boolean)

Acrescenta a representação de cadeia de caracteres de um valor booliano especificado à essa instância.Appends the string representation of a specified Boolean value to this instance.

Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>)

Acrescenta a representação de cadeia de caracteres de um intervalo de caracteres somente leitura a essa instância.Appends the string representation of a specified read-only character span to this instance.

Append(Char) Append(Char) Append(Char) Append(Char)

Acrescenta a representação de cadeia de caracteres de um objeto Char especificado à essa instância.Appends the string representation of a specified Char object to this instance.

Append(Char[]) Append(Char[]) Append(Char[]) Append(Char[])

Acrescenta a representação de cadeia de caracteres dos caracteres Unicode em uma matriz especificada a essa instância.Appends the string representation of the Unicode characters in a specified array to this instance.

Append(Decimal) Append(Decimal) Append(Decimal) Append(Decimal)

Acrescenta a representação de cadeia de caracteres de um número decimal especificado à essa instância.Appends the string representation of a specified decimal number to this instance.

Append(Byte) Append(Byte) Append(Byte) Append(Byte)

Acrescenta a representação de cadeia de caracteres de um inteiro sem sinal de 8 bits especificado a essa instância.Appends the string representation of a specified 8-bit unsigned integer to this instance.

Append(Int16) Append(Int16) Append(Int16) Append(Int16)

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 16 bits especificado a essa instância.Appends the string representation of a specified 16-bit signed integer to this instance.

Append(Int32) Append(Int32) Append(Int32) Append(Int32)

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 32 bits especificado a essa instância.Appends the string representation of a specified 32-bit signed integer to this instance.

Append(Int64) Append(Int64) Append(Int64) Append(Int64)

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 64 bits especificado a essa instância.Appends the string representation of a specified 64-bit signed integer to this instance.

Append(Object) Append(Object) Append(Object) Append(Object)

Acrescenta a representação de cadeia de caracteres de um objeto especificado à essa instância.Appends the string representation of a specified object to this instance.

Append(Double) Append(Double) Append(Double) Append(Double)

Acrescenta a representação de cadeia de caracteres de um número de ponto flutuante de precisão dupla especificado a essa instância.Appends the string representation of a specified double-precision floating-point number to this instance.

Append(StringBuilder) Append(StringBuilder) Append(StringBuilder) Append(StringBuilder)

Acrescenta a representação de cadeia de caracteres de um construtor de cadeia de caracteres especificado a essa instância.Appends the string representation of a specified string builder to this instance.

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value);
public System.Text.StringBuilder Append (System.Text.StringBuilder value);
member this.Append : System.Text.StringBuilder -> System.Text.StringBuilder
Public Function Append (value As StringBuilder) As StringBuilder

Parâmetros

value
StringBuilder StringBuilder StringBuilder StringBuilder

O construtor de cadeia de caracteres a ser acrescentado.The string builder to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation is completed.

Append(UInt16) Append(UInt16) Append(UInt16) Append(UInt16)

Importante

Esta API não está em conformidade com CLS.

Acrescenta a representação de cadeia de caracteres de um inteiro sem sinal de 16 bits especificado a essa instância.Appends the string representation of a specified 16-bit unsigned integer to this instance.

public:
 System::Text::StringBuilder ^ Append(System::UInt16 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ushort value);
member this.Append : uint16 -> System.Text.StringBuilder
Public Function Append (value As UShort) As StringBuilder

Parâmetros

value
UInt16 UInt16 UInt16 UInt16

O valor a ser acrescentado.The value to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(UInt16) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(UInt16) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 16-bit unsigned integer: ");
sb.Append(UInt16.MinValue).Append(" to ").Append(UInt16.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 16-bit unsigned integer: 0 to 65535
Dim sb As New System.Text.StringBuilder("The range of a 16-bit unsigned integer: ")
sb.Append(UInt16.MinValue).Append(" to ").Append(UInt16.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 16-bit unsigned integer: 0 to 65535

O Append(UInt16) método chama o UInt16.ToString(IFormatProvider) método para obter a representação de cadeia valuede caracteres de.The Append(UInt16) method calls the UInt16.ToString(IFormatProvider) method to get the string representation of value. Para controlar a formatação de value, chame o AppendFormat método.To control the formatting of value, call the AppendFormat method.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(UInt32) Append(UInt32) Append(UInt32) Append(UInt32)

Importante

Esta API não está em conformidade com CLS.

Acrescenta a representação de cadeia de caracteres de um inteiro sem sinal de 32 bits especificado a essa instância.Appends the string representation of a specified 32-bit unsigned integer to this instance.

public:
 System::Text::StringBuilder ^ Append(System::UInt32 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (uint value);
member this.Append : uint32 -> System.Text.StringBuilder
Public Function Append (value As UInteger) As StringBuilder

Parâmetros

value
UInt32 UInt32 UInt32 UInt32

O valor a ser acrescentado.The value to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(UInt32) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(UInt32) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 32-bit unsigned integer: ");
sb.Append(UInt32.MinValue).Append(" to ").Append(UInt32.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 32-bit unsigned integer: 0 to 4294967295
Dim sb As New System.Text.StringBuilder("The range of a 32-bit unsigned integer: ")
sb.Append(UInt32.MinValue).Append(" to ").Append(UInt32.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 32-bit unsigned integer: 0 to 4294967295

O Append(UInt32) chama o UInt32.ToString método para obter a representação da cadeia value de caracteres de para a cultura atual.The Append(UInt32) calls the UInt32.ToString method to get the string representation of value for the current culture. Para controlar a formatação de value, chame o AppendFormat método.To control the formatting of value, call the AppendFormat method.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(UInt64) Append(UInt64) Append(UInt64) Append(UInt64)

Importante

Esta API não está em conformidade com CLS.

Acrescenta a representação de cadeia de caracteres de um inteiro sem sinal de 64 bits especificado a essa instância.Appends the string representation of a specified 64-bit unsigned integer to this instance.

public:
 System::Text::StringBuilder ^ Append(System::UInt64 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ulong value);
member this.Append : uint64 -> System.Text.StringBuilder
Public Function Append (value As ULong) As StringBuilder

Parâmetros

value
UInt64 UInt64 UInt64 UInt64

O valor a ser acrescentado.The value to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(UInt64) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(UInt64) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 64-bit unsigned integer: ");
sb.Append(UInt64.MinValue).Append(" to ").Append(UInt64.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 64-bit unsigned integer: 0 to 18446744073709551615
Dim sb As New System.Text.StringBuilder("The range of a 64-bit unsigned integer: ")
sb.Append(UInt64.MinValue).Append(" to ").Append(UInt64.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 64-bit unsigned integer: 0 to 18446744073709551615

O Append(UInt64) método chama o UInt64.ToString(IFormatProvider) método para obter a representação da cadeia value de caracteres de para a cultura atual.The Append(UInt64) method calls the UInt64.ToString(IFormatProvider) method to get the string representation of value for the current culture. Para controlar a formatação de value, chame o AppendFormat método.To control the formatting of value, call the AppendFormat method.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(Char[], Int32, Int32) Append(Char[], Int32, Int32) Append(Char[], Int32, Int32) Append(Char[], Int32, Int32)

Acrescenta a representação de cadeia de caracteres de uma submatriz especificada de caracteres Unicode à essa instância.Appends the string representation of a specified subarray of Unicode characters to this instance.

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value, int startIndex, int charCount);
public System.Text.StringBuilder Append (char[] value, int startIndex, int charCount);
member this.Append : char[] * int * int -> System.Text.StringBuilder
Public Function Append (value As Char(), startIndex As Integer, charCount As Integer) As StringBuilder

Parâmetros

value
Char[]

Uma matriz de caracteres.A character array.

startIndex
Int32 Int32 Int32 Int32

A posição inicial em value.The starting position in value.

charCount
Int32 Int32 Int32 Int32

O número de caracteres a serem acrescentados.The number of characters to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

value é null e startIndex e charCount não são zero.value is null, and startIndex and charCount are not zero.

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

- ou --or- startIndex é menor que zero.startIndex is less than zero.

- ou --or- startIndex + charCount é maior que o comprimento do value.startIndex + charCount is greater than the length of value.

- ou --or- Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

Esse método acrescenta o intervalo especificado de caracteres na value instância atual.This method appends the specified range of characters in value to the current instance. Se value for null e estartIndex ecount forem zero, nenhuma alteração será feita.If value is null and startIndex and count are both zero, no changes are made.

O Append(Char[], Int32, Int32) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(Char[], Int32, Int32) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

char[] chars = { 'a', 'b', 'c', 'd', 'e'};
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int startPosition = Array.IndexOf(chars, 'a');
int endPosition = Array.IndexOf(chars, 'c');
if (startPosition >= 0 && endPosition >= 0) {
   sb.Append("The array from positions ").Append(startPosition).
             Append(" to ").Append(endPosition).Append(" contains ").
             Append(chars, startPosition, endPosition + 1).Append(".");
   Console.WriteLine(sb);
}             
// The example displays the following output:
//       The array from positions 0 to 2 contains abc.
Dim chars() As Char = { "a"c, "b"c, "c"c, "d"c, "e"c}
Dim sb As New System.Text.StringBuilder()
Dim startPosition As Integer = Array.IndexOf(chars, "a"c)
Dim endPosition As Integer = Array.IndexOf(chars, "c"c)
If startPosition >= 0 AndAlso endPosition >= 0 Then
   sb.Append("The array from positions ").Append(startPosition).
             Append(" to ").Append(endPosition).Append(" contains ").
             Append(chars, startPosition, endPosition + 1).Append(".")
   Console.WriteLine(sb)
End If             
' The example displays the following output:
'       The array from positions 0 to 2 contains abc.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(Char*, Int32) Append(Char*, Int32) Append(Char*, Int32)

Importante

Esta API não está em conformidade com CLS.

Alternativa em conformidade com CLS
System.Text.StringBuilder.Append(Char[], Int32, Int32)

Acrescenta uma matriz de caracteres Unicode começando em um endereço especificado a essa instância.Appends an array of Unicode characters starting at a specified address to this instance.

public:
 System::Text::StringBuilder ^ Append(char* value, int valueCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public System.Text.StringBuilder Append (char* value, int valueCount);
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder

Parâmetros

value
Char*

Um ponteiro para uma matriz de caracteres.A pointer to an array of characters.

valueCount
Int32 Int32 Int32 Int32

O número de caracteres na matriz.The number of characters in the array.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

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

- ou --or- Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

Esse método acrescenta valueCount caracteres que começam no endereço value para a instância atual.This method appends valueCount characters starting at address value to the current instance.

O Append(Char*, Int32) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(Char*, Int32) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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.

Append(String) Append(String) Append(String) Append(String)

Acrescenta uma cópia da cadeia de caracteres especificada a essa instância.Appends a copy of the specified string to this instance.

public:
 System::Text::StringBuilder ^ Append(System::String ^ value);
public System.Text.StringBuilder Append (string value);
member this.Append : string -> System.Text.StringBuilder
Public Function Append (value As String) As StringBuilder

Parâmetros

value
String String String String

A cadeia de caracteres a ser acrescentada.The string to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(String) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(String) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

bool flag = false;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The value of the flag is ").Append(flag).Append(".");
Console.WriteLine(sb.ToString());
// The example displays the following output:
//       The value of the flag is False.
Dim flag As Boolean = false
Dim sb As New System.Text.StringBuilder
sb.Append("The value of the flag is ").Append(flag).Append(".")
Console.WriteLine(sb.ToString())
' The example displays the following output:
'       The value of the flag is False.

Se value fornull, nenhuma alteração será feita.If value is null, no changes are made.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32)

Acrescenta uma cópia de uma subcadeia de caracteres especificada a esta instância.Appends a copy of a specified substring to this instance.

public:
 System::Text::StringBuilder ^ Append(System::String ^ value, int startIndex, int count);
public System.Text.StringBuilder Append (string value, int startIndex, int count);
member this.Append : string * int * int -> System.Text.StringBuilder
Public Function Append (value As String, startIndex As Integer, count As Integer) As StringBuilder

Parâmetros

value
String String String String

A cadeia de caracteres que contém a subcadeia de caracteres a ser acrescentada.The string that contains the substring to append.

startIndex
Int32 Int32 Int32 Int32

A posição inicial da subcadeia de caracteres dentro de value.The starting position of the substring within value.

count
Int32 Int32 Int32 Int32

O número de caracteres em value a serem acrescentados.The number of characters in value to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

value é null e startIndex e count não são zero.value is null, and startIndex and count are not zero.

count menor que zero.count less than zero.

- ou --or- startIndex menor que zero.startIndex less than zero.

- ou --or- startIndex + count é maior que o comprimento do value.startIndex + count is greater than the length of value.

- ou --or- Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

Esse método acrescenta o intervalo especificado de caracteres na value instância atual.This method appends the specified range of characters in value to the current instance. Se value for null e estartIndex ecount forem zero, nenhuma alteração será feita.If value is null and startIndex and count are both zero, no changes are made.

O Append(String, Int32, Int32) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(String, Int32, Int32) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

string str = "First;George Washington;1789;1797";
int index = 0;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int length = str.IndexOf(';', index);      
sb.Append(str, index, length).Append(" President of the United States: ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(", from ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(" to ");
index += length + 1;
sb.Append(str, index, str.Length - index);
Console.WriteLine(sb);
// The example displays the following output:
//    First President of the United States: George Washington, from 1789 to 1797      
Dim str As String = "First;George Washington;1789;1797"
Dim index As Integer = 0
Dim sb As New System.Text.StringBuilder()
Dim length As Integer = str.IndexOf(";"c, index)      
sb.Append(str, index, length).Append(" President of the United States: ")
index += length + 1
length = str.IndexOf(";"c, index) - index
sb.Append(str, index, length).Append(", from ")
index += length + 1
length = str.IndexOf(";"c, index) - index
sb.Append(str, index, length).Append(" to ")
index += length + 1
sb.Append(str, index, str.Length - index)
Console.WriteLine(sb)
' The example displays the following output:
'    First President of the United States: George Washington, from 1789 to 1797      

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32)

Acrescenta uma cópia de uma substring em um construtor de cadeia de caracteres especificado a essa instância.Appends a copy of a substring within a specified string builder to this instance.

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value, int startIndex, int count);
public System.Text.StringBuilder Append (System.Text.StringBuilder value, int startIndex, int count);
member this.Append : System.Text.StringBuilder * int * int -> System.Text.StringBuilder
Public Function Append (value As StringBuilder, startIndex As Integer, count As Integer) As StringBuilder

Parâmetros

value
StringBuilder StringBuilder StringBuilder StringBuilder

O construtor de cadeia de caracteres que contém a substring a ser acrescentada.The string builder that contains the substring to append.

startIndex
Int32 Int32 Int32 Int32

A posição inicial da subcadeia de caracteres dentro de value.The starting position of the substring within value.

count
Int32 Int32 Int32 Int32

O número de caracteres em value a serem acrescentados.The number of characters in value to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Append(Char, Int32) Append(Char, Int32) Append(Char, Int32) Append(Char, Int32)

Acrescenta um número de cópias especificado da representação de cadeia de caracteres de um caractere Unicode a essa instância.Appends a specified number of copies of the string representation of a Unicode character to this instance.

public:
 System::Text::StringBuilder ^ Append(char value, int repeatCount);
public System.Text.StringBuilder Append (char value, int repeatCount);
member this.Append : char * int -> System.Text.StringBuilder
Public Function Append (value As Char, repeatCount As Integer) As StringBuilder

Parâmetros

value
Char Char Char Char

O caractere a ser acrescentado.The character to append.

repeatCount
Int32 Int32 Int32 Int32

O value do número de vezes para acrescentar.The number of times to append value.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

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

- ou --or- Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(Char, Int32) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(Char, Int32) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).AppendFormat("{0:C2}", value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****$1,346.19*****
Dim value As Decimal = 1346.19d
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).AppendFormat("{0:C2}", value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****$1,346.19*****

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(SByte) Append(SByte) Append(SByte) Append(SByte)

Importante

Esta API não está em conformidade com CLS.

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 8 bits especificado a essa instância.Appends the string representation of a specified 8-bit signed integer to this instance.

public:
 System::Text::StringBuilder ^ Append(System::SByte value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (sbyte value);
member this.Append : sbyte -> System.Text.StringBuilder
Public Function Append (value As SByte) As StringBuilder

Parâmetros

value
SByte SByte SByte SByte

O valor a ser acrescentado.The value to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(SByte) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(SByte) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of an 8-bit signed integer: ");
sb.Append(SByte.MinValue).Append(" to ").Append(SByte.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of an 8-bit unsigned integer: -128 to 127 
Dim sb As New System.Text.StringBuilder("The range of an 8-bit signed integer: ")
sb.Append(SByte.MinValue).Append(" to ").Append(SByte.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of an 8-bit unsigned integer: -128 to 127 

O Append(SByte) método chama o SByte.ToString(IFormatProvider) método para obter a representação da cadeia value de caracteres de para a cultura atual.The Append(SByte) method calls the SByte.ToString(IFormatProvider) method to get the string representation of value for the current culture. Para controlar a formatação de value, chame o AppendFormat método.To control the formatting of value, call the AppendFormat method.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(Single) Append(Single) Append(Single) Append(Single)

Acrescenta a representação de cadeia de caracteres de um número de ponto flutuante de precisão simples especificado a essa instância.Appends the string representation of a specified single-precision floating-point number to this instance.

public:
 System::Text::StringBuilder ^ Append(float value);
public System.Text.StringBuilder Append (float value);
member this.Append : single -> System.Text.StringBuilder
Public Function Append (value As Single) As StringBuilder

Parâmetros

value
Single Single Single Single

O valor a ser acrescentado.The value to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(Single) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(Single) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

float value = 1034769.47f;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1034769.47*****
Dim value As Single = 1034769.47
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1034769.47*****

O Append(Single) método chama o Single.ToString método para obter a representação da cadeia value de caracteres de para a cultura atual.The Append(Single) method calls the Single.ToString method to get the string representation of value for the current culture. Para controlar a formatação de value, chame o AppendFormat método.To control the formatting of value, call the AppendFormat method.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(ReadOnlyMemory<Char>) Append(ReadOnlyMemory<Char>) Append(ReadOnlyMemory<Char>) Append(ReadOnlyMemory<Char>)

Acrescenta a representação de cadeia de caracteres de uma região de memória do caractere somente leitura a essa instância.Appends the string representation of a specified read-only character memory region to this instance.

public:
 System::Text::StringBuilder ^ Append(ReadOnlyMemory<char> value);
public System.Text.StringBuilder Append (ReadOnlyMemory<char> value);
member this.Append : ReadOnlyMemory<char> -> System.Text.StringBuilder
Public Function Append (value As ReadOnlyMemory(Of Char)) As StringBuilder

Parâmetros

value
ReadOnlyMemory<Char>

A região de memória do caractere somente leitura a ser acrescentado.The read-only character memory region to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation is completed.

Append(Boolean) Append(Boolean) Append(Boolean) Append(Boolean)

Acrescenta a representação de cadeia de caracteres de um valor booliano especificado à essa instância.Appends the string representation of a specified Boolean value to this instance.

public:
 System::Text::StringBuilder ^ Append(bool value);
public System.Text.StringBuilder Append (bool value);
member this.Append : bool -> System.Text.StringBuilder
Public Function Append (value As Boolean) As StringBuilder

Parâmetros

value
Boolean Boolean Boolean Boolean

O valor booliano a ser acrescentado.The Boolean value to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(Boolean) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(Boolean) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

bool flag = false;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The value of the flag is ").Append(flag).Append(".");
Console.WriteLine(sb.ToString());
// The example displays the following output:
//       The value of the flag is False.
Dim flag As Boolean = false
Dim sb As New System.Text.StringBuilder
sb.Append("The value of the flag is ").Append(flag).Append(".")
Console.WriteLine(sb.ToString())
' The example displays the following output:
'       The value of the flag is False.

O Append(Boolean) método chama o Boolean.ToString() método para obter a representação de cadeia valuede caracteres de.The Append(Boolean) method calls the Boolean.ToString() method to get the string representation of value. A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>)

Acrescenta a representação de cadeia de caracteres de um intervalo de caracteres somente leitura a essa instância.Appends the string representation of a specified read-only character span to this instance.

public:
 System::Text::StringBuilder ^ Append(ReadOnlySpan<char> value);
public System.Text.StringBuilder Append (ReadOnlySpan<char> value);
member this.Append : ReadOnlySpan<char> -> System.Text.StringBuilder
Public Function Append (value As ReadOnlySpan(Of Char)) As StringBuilder

Parâmetros

value
ReadOnlySpan<Char>

O intervalo de caracteres somente leitura a ser acrescentado.The read-only character span to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation is completed.

Append(Char) Append(Char) Append(Char) Append(Char)

Acrescenta a representação de cadeia de caracteres de um objeto Char especificado à essa instância.Appends the string representation of a specified Char object to this instance.

public:
 System::Text::StringBuilder ^ Append(char value);
public System.Text.StringBuilder Append (char value);
member this.Append : char -> System.Text.StringBuilder
Public Function Append (value As Char) As StringBuilder

Parâmetros

value
Char Char Char Char

A unidade de código codificado em UTF-16 a ser acrescentado.The UTF-16-encoded code unit to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(Char) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(Char) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

string str = "Characters in a string.";
System.Text.StringBuilder sb = new System.Text.StringBuilder();
foreach (var ch in str)
   sb.Append(" '").Append(ch).Append("' ");

Console.WriteLine("Characters in the string:");
Console.WriteLine("  {0}", sb);
// The example displays the following output:
//    Characters in the string:
//       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'      
Dim str As String = "Characters in a string."
Dim sb As New System.Text.StringBuilder()
For Each ch In str
   sb.Append(" '").Append(ch).Append("' ")
Next
Console.WriteLine("Characters in the string:")
Console.WriteLine("  {0}", sb)
' The example displays the following output:
'    Characters in the string:
'       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'      

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(Char[]) Append(Char[]) Append(Char[]) Append(Char[])

Acrescenta a representação de cadeia de caracteres dos caracteres Unicode em uma matriz especificada a essa instância.Appends the string representation of the Unicode characters in a specified array to this instance.

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value);
public System.Text.StringBuilder Append (char[] value);
member this.Append : char[] -> System.Text.StringBuilder
Public Function Append (value As Char()) As StringBuilder

Parâmetros

value
Char[]

A matriz de caracteres a ser acrescentada.The array of characters to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

Esse método acrescenta todos os caracteres na matriz especificada à instância atual na mesma ordem em que aparecem no value.This method appends all the characters in the specified array to the current instance in the same order as they appear in value. Se value fornull, nenhuma alteração será feita.If value is null, no changes are made.

O Append(Char[]) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(Char[]) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

char[] chars = { 'a', 'e', 'i', 'o', 'u' };
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The characters in the array: ").Append(chars);
Console.WriteLine(sb);
// The example displays the following output:
//      The characters in the array: aeiou
Dim chars() As Char = { "a"c, "e"c, "i"c, "o"c, "u"c }
Dim sb As New System.Text.StringBuilder()
sb.Append("The characters in the array: ").Append(chars)
Console.WriteLine(sb)
' The example displays the following output:
'      The characters in the array: aeiou

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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.

Append(Decimal) Append(Decimal) Append(Decimal) Append(Decimal)

Acrescenta a representação de cadeia de caracteres de um número decimal especificado à essa instância.Appends the string representation of a specified decimal number to this instance.

public:
 System::Text::StringBuilder ^ Append(System::Decimal value);
public System.Text.StringBuilder Append (decimal value);
member this.Append : decimal -> System.Text.StringBuilder
Public Function Append (value As Decimal) As StringBuilder

Parâmetros

value
Decimal Decimal Decimal Decimal

O valor a ser acrescentado.The value to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(Decimal) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(Decimal) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1346.19*****
Dim value As Decimal = 1346.19d
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1346.19*****

O Append(Decimal) método chama o Decimal.ToString(IFormatProvider) método para obter a representação da cadeia value de caracteres de para a cultura atual.The Append(Decimal) method calls the Decimal.ToString(IFormatProvider) method to get the string representation of value for the current culture. Para controlar a formatação de value, chame o AppendFormat método.To control the formatting of value, call the AppendFormat method.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(Byte) Append(Byte) Append(Byte) Append(Byte)

Acrescenta a representação de cadeia de caracteres de um inteiro sem sinal de 8 bits especificado a essa instância.Appends the string representation of a specified 8-bit unsigned integer to this instance.

public:
 System::Text::StringBuilder ^ Append(System::Byte value);
public System.Text.StringBuilder Append (byte value);
member this.Append : byte -> System.Text.StringBuilder
Public Function Append (value As Byte) As StringBuilder

Parâmetros

value
Byte Byte Byte Byte

O valor a ser acrescentado.The value to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(Byte) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(Byte) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

Byte[] bytes = { 16, 132, 27, 253 };
System.Text.StringBuilder sb = new System.Text.StringBuilder();
foreach (var value in bytes)
   sb.Append(value).Append(" ");         

Console.WriteLine("The byte array: {0}", sb.ToString());
// The example displays the following output:
//         The byte array: 16 132 27 253      
Dim bytes() As Byte = { 16, 132, 27, 253 }
Dim sb As New System.Text.StringBuilder()
For Each value In bytes
   sb.Append(value).Append(" ")         
Next
Console.WriteLine("The byte array: {0}", sb.ToString())
' The example displays the following output:
'         The byte array: 16 132 27 253      

O Append(Byte) método chama o ToString(IFormatProvider) método para obter a representação da cadeia value de caracteres de para a cultura atual.The Append(Byte) method calls the ToString(IFormatProvider) method to get the string representation of value for the current culture. Para controlar a formatação de value, chame o AppendFormat método.To control the formatting of value, call the AppendFormat method.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(Int16) Append(Int16) Append(Int16) Append(Int16)

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 16 bits especificado a essa instância.Appends the string representation of a specified 16-bit signed integer to this instance.

public:
 System::Text::StringBuilder ^ Append(short value);
public System.Text.StringBuilder Append (short value);
member this.Append : int16 -> System.Text.StringBuilder
Public Function Append (value As Short) As StringBuilder

Parâmetros

value
Int16 Int16 Int16 Int16

O valor a ser acrescentado.The value to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(Int16) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(Int16) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

System.Text.StringBuilder sb = new 
       System.Text.StringBuilder("The range of a 16-bit integer: ");
sb.Append(Int16.MinValue).Append(" to ").Append(Int16.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 16-bit integer: -32768 to 32767
Dim sb As New System.Text.StringBuilder("The range of a 16-bit integer: ")
sb.Append(Int16.MinValue).Append(" to ").Append(Int16.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 16-bit integer: -32768 to 32767

O Append(Int16) método chama o Int16.ToString(IFormatProvider) método para obter a representação da cadeia value de caracteres de para a cultura atual.The Append(Int16) method calls the Int16.ToString(IFormatProvider) method to get the string representation of value for the current culture. Para controlar a formatação de value, chame o AppendFormat método.To control the formatting of value, call the AppendFormat method.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(Int32) Append(Int32) Append(Int32) Append(Int32)

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 32 bits especificado a essa instância.Appends the string representation of a specified 32-bit signed integer to this instance.

public:
 System::Text::StringBuilder ^ Append(int value);
public System.Text.StringBuilder Append (int value);
member this.Append : int -> System.Text.StringBuilder
Public Function Append (value As Integer) As StringBuilder

Parâmetros

value
Int32 Int32 Int32 Int32

O valor a ser acrescentado.The value to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(Int32) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(Int32) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

System.Text.StringBuilder sb = new 
       System.Text.StringBuilder("The range of a 32-bit integer: ");
sb.Append(Int32.MinValue).Append(" to ").Append(Int32.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 32-bit integer: -2147483648 to 2147483647
Dim sb As New System.Text.StringBuilder("The range of a 32-bit integer: ")
sb.Append(Int32.MinValue).Append(" to ").Append(Int32.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 32-bit integer: -2147483648 to 2147483647

O Append(Int32) método chama o Int32.ToString(IFormatProvider) método para obter a representação da cadeia value de caracteres de para a cultura atual.The Append(Int32) method calls the Int32.ToString(IFormatProvider) method to get the string representation of value for the current culture. Para controlar a formatação de value, chame o AppendFormat método.To control the formatting of value, call the AppendFormat method.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(Int64) Append(Int64) Append(Int64) Append(Int64)

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 64 bits especificado a essa instância.Appends the string representation of a specified 64-bit signed integer to this instance.

public:
 System::Text::StringBuilder ^ Append(long value);
public System.Text.StringBuilder Append (long value);
member this.Append : int64 -> System.Text.StringBuilder
Public Function Append (value As Long) As StringBuilder

Parâmetros

value
Int64 Int64 Int64 Int64

O valor a ser acrescentado.The value to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(Int64) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(Int64) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 64-bit integer: ");
sb.Append(Int64.MinValue).Append(" to ").Append(Int64.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807
Dim sb As New System.Text.StringBuilder("The range of a 64-bit integer: ")
sb.Append(Int64.MinValue).Append(" to ").Append(Int64.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807

O Append(Int64) método chama o Int64.ToString(IFormatProvider) para obter a representação de cadeia value de caracteres de para a cultura atual.The Append(Int64) method calls the Int64.ToString(IFormatProvider) to get the string representation of value for the current culture. Para controlar a formatação de value, chame o AppendFormat método.To control the formatting of value, call the AppendFormat method.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(Object) Append(Object) Append(Object) Append(Object)

Acrescenta a representação de cadeia de caracteres de um objeto especificado à essa instância.Appends the string representation of a specified object to this instance.

public:
 System::Text::StringBuilder ^ Append(System::Object ^ value);
public System.Text.StringBuilder Append (object value);
member this.Append : obj -> System.Text.StringBuilder
Public Function Append (value As Object) As StringBuilder

Parâmetros

value
Object Object Object Object

O objeto a ser acrescentado.The object to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(Object) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(Object) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates. Ele define uma Dog classe, cria um Dog objeto e faz três chamadas para o Append método para criar uma cadeia de caracteres que contenha o nome e a categoria do cachorro.It defines a Dog class, creates a Dog object, and makes three calls to the Append method to create a string that contains the dog's name and breed.

using System;

public class Dog
{
   private string dogBreed;
   private string dogName;
   
   public Dog(string name, string breed)
   {
      this.dogName = name;
      this.dogBreed = breed;
   }
   
   public string Breed {
      get { return this.dogBreed; }
   }
   
   public string Name {
      get { return this.dogName; }
   }
   
   public override string ToString()
   {
      return this.dogName;
   }
}

public class Example
{
   public static void Main()
   {
      Dog dog1 = new Dog("Yiska", "Alaskan Malamute");
      System.Text.StringBuilder sb = new System.Text.StringBuilder();     
      sb.Append(dog1).Append(", Breed: ").Append(dog1.Breed);  
      Console.WriteLine(sb);
   }
}
// The example displays the following output:
//        Yiska, Breed: Alaskan Malamute
Public Class Dog
   Private dogBreed As String
   Private dogName As String
   
   Public Sub New(name As String, breed As String)
      Me.dogName = name
      Me.dogBreed = breed
   End Sub
   
   Public ReadOnly Property Breed As String
      Get
         Return Me.dogBreed
      End Get
   End Property
   
   Public ReadOnly Property Name As String
      Get
         Return Me.dogName
      End Get
   End Property
   
   Public Overrides Function ToString() As String
      Return Me.dogName
   End Function
End Class
   
Module Example
   Public Sub Main()
      Dim dog1 As New Dog("Yiska", "Alaskan Malamute")
      Dim sb As New System.Text.StringBuilder()     
      sb.Append(dog1).Append(", Breed: ").Append(dog1.Breed)  
      Console.WriteLine(sb)
   End Sub
End Module
' The example displays the following output:
'       Yiska, Breed: Alaskan Malamute

O Append(Object) método chama o Object.ToString método para obter a representação de cadeia valuede caracteres de.The Append(Object) method calls the Object.ToString method to get the string representation of value. Se value for null, nenhumaStringBuilder alteração será feita no objeto.If value is null, no changes are made to the StringBuilder object.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Append(Double) Append(Double) Append(Double) Append(Double)

Acrescenta a representação de cadeia de caracteres de um número de ponto flutuante de precisão dupla especificado a essa instância.Appends the string representation of a specified double-precision floating-point number to this instance.

public:
 System::Text::StringBuilder ^ Append(double value);
public System.Text.StringBuilder Append (double value);
member this.Append : double -> System.Text.StringBuilder
Public Function Append (value As Double) As StringBuilder

Parâmetros

value
Double Double Double Double

O valor a ser acrescentado.The value to append.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.A reference to this instance after the append operation has completed.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.Enlarging the value of this instance would exceed MaxCapacity.

Comentários

O Append(Double) método modifica a instância existente dessa classe; ela não retorna uma nova instância de classe.The Append(Double) method modifies the existing instance of this class; it does not return a new class instance. Por isso, você pode chamar um método ou uma propriedade na referência existente e não precisa atribuir o valor de retorno a um StringBuilder objeto, como ilustra o exemplo a seguir.Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

double value = 1034769.47;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1034769.47*****
Dim value As Double = 1034769.47
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1034769.47*****

O Append(Double) método chama o Double.ToString(IFormatProvider) método para obter a representação da cadeia value de caracteres de para a cultura atual.The Append(Double) method calls the Double.ToString(IFormatProvider) method to get the string representation of value for the current culture. Para controlar a formatação de value, chame o AppendFormat método.To control the formatting of value, call the AppendFormat method.

A capacidade dessa instância é ajustada conforme necessário.The capacity of this instance is adjusted as needed.

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

Aplica-se a