StringBuilder.Append Método

Definição

Acrescenta a representação de cadeia de caracteres de um objeto especificado à essa instância.

Sobrecargas

Append(StringBuilder)

Acrescenta a representação de cadeia de caracteres de um construtor de cadeia de caracteres especificado a essa instância.

Append(StringBuilder+AppendInterpolatedStringHandler)

Acrescenta a cadeia de caracteres interpolada especificada a essa instância.

Append(UInt16)

Acrescenta a representação de cadeia de caracteres de um inteiro sem sinal de 16 bits especificado a essa instância.

Append(UInt32)

Acrescenta a representação de cadeia de caracteres de um inteiro sem sinal de 32 bits especificado a essa instância.

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.

Append(Char[], Int32, Int32)

Acrescenta a representação de cadeia de caracteres de uma submatriz especificada de caracteres Unicode à essa instância.

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Acrescenta a cadeia de caracteres interpolada especificada a essa instância usando o formato especificado.

Append(String)

Acrescenta uma cópia da cadeia de caracteres especificada a essa instância.

Append(String, Int32, Int32)

Acrescenta uma cópia de uma subcadeia de caracteres especificada a esta instância.

Append(StringBuilder, Int32, Int32)

Acrescenta uma cópia de uma substring em um construtor de cadeia de caracteres especificado a essa instância.

Append(Char*, Int32)

Acrescenta uma matriz de caracteres Unicode começando em um endereço especificado a essa instância.

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.

Append(UInt64)

Acrescenta a representação de cadeia de caracteres de um inteiro sem sinal de 64 bits especificado a essa instância.

Append(ReadOnlySpan<Char>)

Acrescenta a representação de cadeia de caracteres de um intervalo de caracteres somente leitura a essa instância.

Append(SByte)

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 8 bits especificado a essa instância.

Append(Boolean)

Acrescenta a representação de cadeia de caracteres de um valor booliano especificado à essa instância.

Append(Byte)

Acrescenta a representação de cadeia de caracteres de um inteiro sem sinal de 8 bits especificado a essa instância.

Append(Char)

Acrescenta a representação de cadeia de caracteres de um objeto Char especificado à essa instância.

Append(Decimal)

Acrescenta a representação de cadeia de caracteres de um número decimal especificado à essa instância.

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.

Append(Char[])

Acrescenta a representação de cadeia de caracteres dos caracteres Unicode em uma matriz especificada a essa instância.

Append(Int16)

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 16 bits especificado a essa instância.

Append(Int32)

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 32 bits especificado a essa instância.

Append(Int64)

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 64 bits especificado a essa instância.

Append(Object)

Acrescenta a representação de cadeia de caracteres de um objeto especificado à essa instância.

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.

Append(StringBuilder)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres de um construtor de cadeia de caracteres especificado a essa instância.

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value);
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

O construtor de cadeia de caracteres a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Aplica-se a

Append(StringBuilder+AppendInterpolatedStringHandler)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a cadeia de caracteres interpolada especificada a essa instância.

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);
public System.Text.StringBuilder Append (ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);
member this.Append : AppendInterpolatedStringHandler -> System.Text.StringBuilder
Public Function Append (ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Parâmetros

handler
StringBuilder.AppendInterpolatedStringHandler

A cadeia de caracteres interpolada a ser acrescentada.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Aplica-se a

Append(UInt16)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

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.

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

Parâmetros

value
UInt16

O valor a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Atributos

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(UInt16) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto , como ilustra o exemplo a seguir.

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
let sb = StringBuilder "The range of a 16-bit unsigned integer: "
sb.Append(UInt16.MinValue).Append(" to ").Append UInt16.MaxValue |> ignore
printfn $"{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 de caracteres de value. Para controlar a formatação de value, chame o AppendFormat método .

A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

No .NET Core e no .NET Framework 4.0 e versões posteriores, quando você cria uma instância do StringBuilder objeto chamando o StringBuilder(Int32, Int32) construtor, o comprimento e 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

Append(UInt32)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

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.

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

Parâmetros

value
UInt32

O valor a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Atributos

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(UInt32) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto , como ilustra o exemplo a seguir.

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
let sb = StringBuilder "The range of a 32-bit unsigned integer: "
sb.Append(UInt32.MinValue).Append(" to ").Append UInt32.MaxValue |> ignore
printfn $"{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 de cadeia de caracteres de value para a cultura atual. Para controlar a formatação de value, chame o AppendFormat método .

A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

No .NET Core e no .NET Framework 4.0 e versões posteriores, quando você cria uma instância do StringBuilder objeto chamando o StringBuilder(Int32, Int32) construtor, o comprimento e 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

Append(Char, Int32)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta um número de cópias especificado da representação de cadeia de caracteres de um caractere Unicode a essa instância.

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

O caractere a ser acrescentado.

repeatCount
Int32

O value do número de vezes para acrescentar.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

repeatCount é menor que zero.

- ou -

Aumentar o valor dessa instância excederia MaxCapacity.

Sem memória.

Comentários

O Append(Char, Int32) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto , como ilustra o exemplo a seguir.

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*****
let value = 1346.19m
let sb = StringBuilder()
sb.Append('*', 5).AppendFormat("{0:C2}", value).Append('*', 5) |> ignore
printfn $"{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.

Notas aos Chamadores

No .NET Core e no .NET Framework 4.0 e versões posteriores, quando você cria uma instância do StringBuilder objeto chamando o StringBuilder(Int32, Int32) construtor, o comprimento e 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

Append(Char[], Int32, Int32)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres de uma submatriz especificada de caracteres Unicode à essa instância.

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value, int startIndex, int charCount);
public System.Text.StringBuilder Append (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.

startIndex
Int32

A posição inicial em value.

charCount
Int32

O número de caracteres a serem acrescentados.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

value é null e startIndex e charCount não são zero.

charCount é menor que zero.

- ou -

startIndex é menor que zero.

- ou -

startIndex + charCount é maior que o comprimento do value.

- ou -

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Esse método acrescenta o intervalo especificado de caracteres na value instância atual. Se value for null e startIndex e count ambos forem zero, nenhuma alteração será feita.

O Append(Char[], Int32, Int32) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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.
let chars = [| 'a'; 'b'; 'c'; 'd'; 'e' |]
let sb = StringBuilder()
let startPosition = Array.IndexOf(chars, 'a')
let endPosition = Array.IndexOf(chars, 'c')

if startPosition >= 0 && endPosition >= 0 then
    sb
        .Append("The array from positions ")
        .Append(startPosition)
        .Append(" to ")
        .Append(endPosition)
        .Append(" contains ")
        .Append(chars, startPosition, endPosition + 1)
        .Append "."
    |> ignore

    printfn $"{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.

Notas aos Chamadores

No .NET Core e no .NET Framework 4.0 e versões posteriores, quando você cria uma instância do StringBuilder objeto chamando o StringBuilder(Int32, Int32) construtor, o comprimento e 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

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a cadeia de caracteres interpolada especificada a essa instância usando o formato especificado.

public:
 System::Text::StringBuilder ^ Append(IFormatProvider ^ provider, System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);
public System.Text.StringBuilder Append (IFormatProvider? provider, ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);
member this.Append : IFormatProvider * AppendInterpolatedStringHandler -> System.Text.StringBuilder
Public Function Append (provider As IFormatProvider, ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Parâmetros

provider
IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura.

handler
StringBuilder.AppendInterpolatedStringHandler

A cadeia de caracteres interpolada a ser acrescentada.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Aplica-se a

Append(String)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta uma cópia da cadeia de caracteres especificada a essa instância.

public:
 System::Text::StringBuilder ^ Append(System::String ^ value);
public System.Text.StringBuilder Append (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

A cadeia de caracteres a ser acrescentada.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(String) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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.
let flag = false
let sb = StringBuilder()
sb.Append("The value of the flag is ").Append(flag).Append "." |> ignore
printfn $"{sb}"
// 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 for null, nenhuma alteração será feita.

A capacidade dessa instância é ajustada conforme necessário.

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

Append(String, Int32, Int32)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta uma cópia de uma subcadeia de caracteres especificada a esta instância.

public:
 System::Text::StringBuilder ^ Append(System::String ^ value, int startIndex, int count);
public System.Text.StringBuilder Append (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

A cadeia de caracteres que contém a subcadeia de caracteres a ser acrescentada.

startIndex
Int32

A posição inicial da subcadeia de caracteres dentro de value.

count
Int32

O número de caracteres em value a serem acrescentados.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

value é null e startIndex e count não são zero.

count menor que zero.

- ou -

startIndex menor que zero.

- ou -

startIndex + count é maior que o comprimento do value.

- ou -

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Esse método acrescenta o intervalo especificado de caracteres na value instância atual. Se value for null e startIndex e count ambos forem zero, nenhuma alteração será feita.

O Append(String, Int32, Int32) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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
let str = "First;George Washington;1789;1797"
let mutable index = 0
let sb = StringBuilder()
let length = str.IndexOf(';', index)

sb.Append(str, index, length).Append " President of the United States: "
|> ignore

index <- index + length + 1
let length = str.IndexOf(';', index) - index
sb.Append(str, index, length).Append ", from " |> ignore
index <- index + length + 1
let length = str.IndexOf(';', index) - index
sb.Append(str, index, length).Append " to " |> ignore
index <- index + length + 1
sb.Append(str, index, str.Length - index) |> ignore
printfn $"{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.

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

Append(StringBuilder, Int32, Int32)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta uma cópia de uma substring em um construtor de cadeia de caracteres especificado a essa instância.

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

O construtor de cadeia de caracteres que contém a substring a ser acrescentada.

startIndex
Int32

A posição inicial da subcadeia de caracteres dentro de value.

count
Int32

O número de caracteres em value a serem acrescentados.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Aplica-se a

Append(Char*, Int32)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

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.

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

Parâmetros

value
Char*

Um ponteiro para uma matriz de caracteres.

valueCount
Int32

O número de caracteres na matriz.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Atributos

Exceções

valueCount é menor que zero.

- ou -

Aumentar o valor dessa instância excederia MaxCapacity.

O value é um ponteiro nulo.

Comentários

Esse método acrescenta caracteres valueCount começando no endereço value para a instância atual.

O Append(Char*, Int32) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto .

A capacidade dessa instância é ajustada conforme necessário.

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.

Aplica-se a

Append(Single)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres de um número de ponto flutuante de precisão simples especificado a essa instância.

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

O valor a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(Single) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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*****
let value = 1034769.47f
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{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 de cadeia de caracteres da value cultura atual. Para controlar a formatação de value, chame o AppendFormat método .

A capacidade dessa instância é ajustada conforme necessário.

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

Append(UInt64)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

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.

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

Parâmetros

value
UInt64

O valor a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Atributos

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(UInt64) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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
let sb = StringBuilder "The range of a 64-bit unsigned integer: "
sb.Append(UInt64.MinValue).Append(" to ").Append UInt64.MaxValue |> ignore
printfn $"{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 de cadeia de caracteres da value cultura atual. Para controlar a formatação de value, chame o AppendFormat método .

A capacidade dessa instância é ajustada conforme necessário.

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

Append(ReadOnlySpan<Char>)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres de um intervalo de caracteres somente leitura a essa instância.

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.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Aplica-se a

Append(SByte)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

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.

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

Parâmetros

value
SByte

O valor a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Atributos

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(SByte) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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
let sb = StringBuilder "The range of an 8-bit signed integer: "
sb.Append(SByte.MinValue).Append(" to ").Append SByte.MaxValue |> ignore
printfn $"{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 de cadeia de caracteres da value cultura atual. Para controlar a formatação de value, chame o AppendFormat método .

A capacidade dessa instância é ajustada conforme necessário.

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

Append(Boolean)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres de um valor booliano especificado à essa instância.

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

O valor booliano a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(Boolean) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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.
let flag = false
let sb = StringBuilder()
sb.Append("The value of the flag is ").Append(flag).Append "." |> ignore
printfn $"{sb}"
// 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 de caracteres de value. A capacidade dessa instância é ajustada conforme necessário.

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

Append(Byte)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres de um inteiro sem sinal de 8 bits especificado a essa instância.

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

O valor a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(Byte) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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
let bytes = [| 16uy; 132uy; 27uy; 253uy |]
let sb = StringBuilder()

for value in bytes do
    sb.Append(value).Append " " |> ignore

printfn $"The byte array: {sb}"
// 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 de cadeia de caracteres da value cultura atual. Para controlar a formatação de value, chame o AppendFormat método .

A capacidade dessa instância é ajustada conforme necessário.

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

Append(Char)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres de um objeto Char especificado à essa instância.

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

A unidade de código codificado em UTF-16 a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(Char) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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'  '.'
let str = "Characters in a string."
let sb = StringBuilder()

for ch in str do
    sb.Append(" '").Append(ch).Append "' " |> ignore

printfn "Characters in the string:"
printfn $"  {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.

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

Append(Decimal)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres de um número decimal especificado à essa instância.

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

O valor a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(Decimal) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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*****
let value = 1346.19m
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{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 de cadeia de caracteres da value cultura atual. Para controlar a formatação de value, chame o AppendFormat método .

A capacidade dessa instância é ajustada conforme necessário.

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

Append(Double)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres de um número de ponto flutuante de precisão dupla especificado a essa instância.

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

O valor a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(Double) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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*****
let value = 1034769.47
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{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 de cadeia de caracteres da value cultura atual. Para controlar a formatação de value, chame o AppendFormat método .

A capacidade dessa instância é ajustada conforme necessário.

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

Append(Char[])

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres dos caracteres Unicode em uma matriz especificada a essa instância.

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value);
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[]

A matriz de caracteres a ser acrescentada.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Esse método acrescenta todos os caracteres na matriz especificada à instância atual na mesma ordem em que aparecem em value. Se value for null, nenhuma alteração será feita.

O Append(Char[]) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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
let chars = [| 'a'; 'e'; 'i'; 'o'; 'u' |]
let sb = StringBuilder()
sb.Append("The characters in the array: ").Append chars |> ignore
printfn $"{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.

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.

Aplica-se a

Append(Int16)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 16 bits especificado a essa instância.

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

O valor a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(Int16) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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
let sb = StringBuilder "The range of a 16-bit integer: "
sb.Append(Int16.MinValue).Append(" to ").Append Int16.MaxValue |> ignore
printfn $"{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 de cadeia de caracteres da value cultura atual. Para controlar a formatação de value, chame o AppendFormat método .

A capacidade dessa instância é ajustada conforme necessário.

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

Append(Int32)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 32 bits especificado a essa instância.

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

O valor a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(Int32) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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
let sb = StringBuilder "The range of a 32-bit integer: "
sb.Append(Int32.MinValue).Append(" to ").Append Int32.MaxValue |> ignore
printfn $"{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 de cadeia de caracteres da value cultura atual. Para controlar a formatação de value, chame o AppendFormat método .

A capacidade dessa instância é ajustada conforme necessário.

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

Append(Int64)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres de um inteiro com sinal de 64 bits especificado a essa instância.

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

O valor a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(Int64) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto, como ilustra o exemplo a seguir.

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
let sb = StringBuilder "The range of a 64-bit integer: "
sb.Append(Int64.MinValue).Append(" to ").Append Int64.MaxValue |> ignore
printfn $"{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 de caracteres de value para a cultura atual. Para controlar a formatação de value, chame o AppendFormat método .

A capacidade dessa instância é ajustada conforme necessário.

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

Append(Object)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres de um objeto especificado à essa instância.

public:
 System::Text::StringBuilder ^ Append(System::Object ^ value);
public System.Text.StringBuilder Append (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

O objeto a ser acrescentado.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Exceções

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

O Append(Object) método modifica a instância existente dessa classe; ele não retorna uma nova instância de classe. Por isso, você pode chamar um método ou propriedade na referência existente e não precisa atribuir o valor retornado a um StringBuilder objeto , como ilustra o exemplo a seguir. 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 contém o nome e a raça do cão.

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
open System.Text

type Dog(name: string, breed: string) =
    member _.Name = name
    member _.Breed = breed
    override _.ToString() = name

let dog1 = Dog("Yiska", "Alaskan Malamute")
let sb = StringBuilder()
sb.Append(dog1).Append(", Breed: ").Append dog1.Breed |> printfn "%O"

// 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 de caracteres de value. Se value for null, nenhuma alteração será feita no StringBuilder objeto .

A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

No .NET Core e no .NET Framework 4.0 e versões posteriores, quando você cria uma instância do StringBuilder objeto chamando o StringBuilder(Int32, Int32) construtor, o comprimento e 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

Append(ReadOnlyMemory<Char>)

Origem:
StringBuilder.cs
Origem:
StringBuilder.cs
Origem:
StringBuilder.cs

Acrescenta a representação de cadeia de caracteres de uma região de memória do caractere somente leitura a essa instância.

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.

Retornos

Uma referência a essa instância após a conclusão da operação de acréscimo.

Aplica-se a