StringBuilder Classe

Definição

Namespace:

System.Text

Assembly:

mscorlib.dll

Representa uma cadeia de caracteres mutável. Essa classe não pode ser herdada.

public ref class StringBuilder sealed : System::Runtime::Serialization::ISerializable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class StringBuilder : System.Runtime.Serialization.ISerializable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringBuilder = class
    interface ISerializable

Public NotInheritable Class StringBuilder
Implements ISerializable

Herança

Object

StringBuilder

Atributos

SerializableAttribute ComVisibleAttribute

Implementações

ISerializable

Exemplos

O exemplo a seguir mostra como chamar muitos dos métodos definidos pela StringBuilder classe.

using System;
using System.Text;

public sealed class App
{
    static void Main()
    {
        // Create a StringBuilder that expects to hold 50 characters.
        // Initialize the StringBuilder with "ABC".
        StringBuilder sb = new StringBuilder("ABC", 50);

        // Append three characters (D, E, and F) to the end of the StringBuilder.
        sb.Append(new char[] { 'D', 'E', 'F' });

        // Append a format string to the end of the StringBuilder.
        sb.AppendFormat("GHI{0}{1}", 'J', 'k');

        // Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString());

        // Insert a string at the beginning of the StringBuilder.
        sb.Insert(0, "Alphabet: ");

        // Replace all lowercase k's with uppercase K's.
        sb.Replace('k', 'K');

        // Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString());
    }
}

// This code produces the following output.
//
// 11 chars: ABCDEFGHIJk
// 21 chars: Alphabet: ABCDEFGHIJK

open System.Text

// Create a StringBuilder that expects to hold 50 characters.
// Initialize the StringBuilder with "ABC".
let sb = StringBuilder("ABC", 50)

// Append three characters (D, E, and F) to the end of the StringBuilder.
sb.Append [| 'D'; 'E'; 'F' |] |> ignore

// Append a format string to the end of the StringBuilder.
sb.AppendFormat("GHI{0}{1}", 'J', 'k') |> ignore

// Display the number of characters in the StringBuilder and its string.
printfn $"{sb.Length} chars: {sb}"

// Insert a string at the beginning of the StringBuilder.
sb.Insert(0, "Alphabet: ") |> ignore

// Replace all lowercase k's with uppercase K's.
sb.Replace('k', 'K') |> ignore

// Display the number of characters in the StringBuilder and its string.
printfn $"{sb.Length} chars: {sb}"

// This code produces the following output.
//
// 11 chars: ABCDEFGHIJk
// 21 chars: Alphabet: ABCDEFGHIJK

Imports System.Text

Public Module App 
    Public Sub Main() 
        ' Create a StringBuilder that expects to hold 50 characters.
        ' Initialize the StringBuilder with "ABC".
        Dim sb As New StringBuilder("ABC", 50)

        ' Append three characters (D, E, and F) to the end of the StringBuilder.
        sb.Append(New Char() {"D"c, "E"c, "F"c})

        ' Append a format string to the end of the StringBuilder.
        sb.AppendFormat("GHI{0}{1}", "J"c, "k"c)

        ' Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString())

        ' Insert a string at the beginning of the StringBuilder.
        sb.Insert(0, "Alphabet: ")

        ' Replace all lowercase k's with uppercase K's.
        sb.Replace("k", "K")

        ' Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString())
    End Sub
End Module

' This code produces the following output.
'
' 11 chars: ABCDEFGHIJk
' 21 chars: Alphabet: ABCDEFGHIJK

Comentários

Para obter mais informações sobre essa API, consulte comentários da API Complementar para StringBuilder.

Notas aos Chamadores

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

Construtores

Nome	Description
StringBuilder()	Inicializa uma nova instância da classe StringBuilder.
StringBuilder(Int32, Int32)	Inicializa uma nova instância da StringBuilder classe que começa com uma capacidade especificada e pode aumentar para um máximo especificado.
StringBuilder(Int32)	Inicializa uma nova instância da StringBuilder classe usando a capacidade especificada.
StringBuilder(String, Int32, Int32, Int32)	Inicializa uma nova instância da classe da StringBuilder subcadeia de caracteres e capacidade especificada.
StringBuilder(String, Int32)	Inicializa uma nova instância da StringBuilder classe usando a cadeia de caracteres e a capacidade especificadas.
StringBuilder(String)	Inicializa uma nova instância da StringBuilder classe usando a cadeia de caracteres especificada.

Propriedades

Nome	Description
Capacity	Obtém ou define o número máximo de caracteres que podem ser contidos na memória alocada pela instância atual.
Chars[Int32]	Obtém ou define o caractere na posição de caractere especificada nesta instância.
Length	Obtém ou define o comprimento do objeto atual StringBuilder .
MaxCapacity	Obtém a capacidade máxima dessa instância.

Métodos

Nome	Description
Append(Boolean)	Acrescenta a representação de cadeia de caracteres de um valor booliano especificado a 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, Int32)	Acrescenta um número especificado de cópias da representação de cadeia de caracteres de um caractere Unicode a essa instância.
Append(Char)	Acrescenta a representação de cadeia de caracteres de um objeto especificado Char a essa instância.
Append(Char[], Int32, Int32)	Acrescenta a representação de cadeia de caracteres de uma subarray especificada de caracteres Unicode 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(Char*, Int32)	Acrescenta uma matriz de caracteres Unicode começando em um endereço especificado para essa instância.
Append(Decimal)	Acrescenta a representação de cadeia de caracteres de um número decimal especificado a 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(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 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(Single)	Acrescenta a representação de cadeia de caracteres de um número de ponto flutuante de precisão única especificado a essa instância.
Append(String, Int32, Int32)	Acrescenta uma cópia de uma subcadeia de caracteres especificada a essa instância.
Append(String)	Acrescenta uma cópia da cadeia de caracteres 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(UInt64)	Acrescenta a representação de cadeia de caracteres de um inteiro sem sinal de 64 bits especificado a essa instância.
AppendFormat(IFormatProvider, String, Object, Object, Object)	Acrescenta a cadeia de caracteres retornada processando uma cadeia de caracteres de formato composto, que contém zero ou mais itens de formato, a esta instância. Cada item de formato é substituído pela representação de cadeia de caracteres de qualquer um dos três argumentos usando um provedor de formato especificado.
AppendFormat(IFormatProvider, String, Object, Object)	Acrescenta a cadeia de caracteres retornada processando uma cadeia de caracteres de formato composto, que contém zero ou mais itens de formato, a esta instância. Cada item de formato é substituído pela representação de cadeia de caracteres de qualquer um dos dois argumentos usando um provedor de formato especificado.
AppendFormat(IFormatProvider, String, Object)	Acrescenta a cadeia de caracteres retornada processando uma cadeia de caracteres de formato composto, que contém zero ou mais itens de formato, a esta instância. Cada item de formato é substituído pela representação de cadeia de caracteres de um único argumento usando um provedor de formato especificado.
AppendFormat(IFormatProvider, String, Object[])	Acrescenta a cadeia de caracteres retornada processando uma cadeia de caracteres de formato composto, que contém zero ou mais itens de formato, a esta instância. Cada item de formato é substituído pela representação de cadeia de caracteres de um argumento correspondente em uma matriz de parâmetros usando um provedor de formato especificado.
AppendFormat(String, Object, Object, Object)	Acrescenta a cadeia de caracteres retornada processando uma cadeia de caracteres de formato composto, que contém zero ou mais itens de formato, a esta instância. Cada item de formato é substituído pela representação de cadeia de caracteres de qualquer um dos três argumentos.
AppendFormat(String, Object, Object)	Acrescenta a cadeia de caracteres retornada processando uma cadeia de caracteres de formato composto, que contém zero ou mais itens de formato, a esta instância. Cada item de formato é substituído pela representação de cadeia de caracteres de um dos dois argumentos.
AppendFormat(String, Object)	Acrescenta a cadeia de caracteres retornada processando uma cadeia de caracteres de formato composto, que contém zero ou mais itens de formato, a esta instância. Cada item de formato é substituído pela representação de cadeia de caracteres de um único argumento.
AppendFormat(String, Object[])	Acrescenta a cadeia de caracteres retornada processando uma cadeia de caracteres de formato composto, que contém zero ou mais itens de formato, a esta instância. Cada item de formato é substituído pela representação de cadeia de caracteres de um argumento correspondente em uma matriz de parâmetros.
AppendLine()	Acrescenta o terminador de linha padrão ao final do objeto atual StringBuilder .
AppendLine(String)	Acrescenta uma cópia da cadeia de caracteres especificada seguida pelo terminador de linha padrão ao final do objeto atual StringBuilder .
Clear()	Remove todos os caracteres da instância atual StringBuilder .
CopyTo(Int32, Char[], Int32, Int32)	Copia os caracteres de um segmento especificado dessa instância para um segmento especificado de uma matriz de destino Char .
EnsureCapacity(Int32)	Garante que a capacidade dessa instância StringBuilder seja pelo menos o valor especificado.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Equals(StringBuilder)	Retorna um valor que indica se essa instância é igual a um objeto especificado.
GetHashCode()	Serve como a função hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Insert(Int32, Boolean)	Insere a representação de cadeia de caracteres de um valor booliano nessa instância na posição de caractere especificada.
Insert(Int32, Byte)	Insere a representação de cadeia de caracteres de um inteiro sem sinal de 8 bits especificado nesta instância na posição de caractere especificada.
Insert(Int32, Char)	Insere a representação de cadeia de caracteres de um caractere Unicode especificado nessa instância na posição de caractere especificada.
Insert(Int32, Char[], Int32, Int32)	Insere a representação de cadeia de caracteres de uma subarray especificada de caracteres Unicode nessa instância na posição de caractere especificada.
Insert(Int32, Char[])	Insere a representação de cadeia de caracteres de uma matriz especificada de caracteres Unicode nessa instância na posição de caractere especificada.
Insert(Int32, Decimal)	Insere a representação de cadeia de caracteres de um número decimal nessa instância na posição de caractere especificada.
Insert(Int32, Double)	Insere a representação de cadeia de caracteres de um número de ponto flutuante de precisão dupla nessa instância na posição de caractere especificada.
Insert(Int32, Int16)	Insere a representação de cadeia de caracteres de um inteiro com sinal de 16 bits especificado nesta instância na posição de caractere especificada.
Insert(Int32, Int32)	Insere a representação de cadeia de caracteres de um inteiro com sinal de 32 bits especificado nesta instância na posição de caractere especificada.
Insert(Int32, Int64)	Insere a representação de cadeia de caracteres de um inteiro com sinal de 64 bits nessa instância na posição de caractere especificada.
Insert(Int32, Object)	Insere a representação de cadeia de caracteres de um objeto nessa instância na posição de caractere especificada.
Insert(Int32, SByte)	Insere a representação de cadeia de caracteres de um inteiro com sinal de 8 bits especificado nesta instância na posição de caractere especificada.
Insert(Int32, Single)	Insere a representação de cadeia de caracteres de um número de ponto flutuante de precisão única nessa instância na posição de caractere especificada.
Insert(Int32, String, Int32)	Insere uma ou mais cópias de uma cadeia de caracteres especificada nessa instância na posição de caractere especificada.
Insert(Int32, String)	Insere uma cadeia de caracteres nessa instância na posição de caractere especificada.
Insert(Int32, UInt16)	Insere a representação de cadeia de caracteres de um inteiro sem sinal de 16 bits nessa instância na posição de caractere especificada.
Insert(Int32, UInt32)	Insere a representação de cadeia de caracteres de um inteiro sem sinal de 32 bits nessa instância na posição de caractere especificada.
Insert(Int32, UInt64)	Insere a representação de cadeia de caracteres de um inteiro sem sinal de 64 bits nessa instância na posição de caractere especificada.
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
Remove(Int32, Int32)	Remove o intervalo de caracteres especificado dessa instância.
Replace(Char, Char, Int32, Int32)	Substitui, dentro de uma subcadeia de caracteres dessa instância, todas as ocorrências de um caractere especificado por outro caractere especificado.
Replace(Char, Char)	Substitui todas as ocorrências de um caractere especificado nesta instância por outro caractere especificado.
Replace(String, String, Int32, Int32)	Substitui, dentro de uma subcadeia de caracteres dessa instância, todas as ocorrências de uma cadeia de caracteres especificada por outra cadeia de caracteres especificada.
Replace(String, String)	Substitui todas as ocorrências de uma cadeia de caracteres especificada nesta instância por outra cadeia de caracteres especificada.
ToString()	Converte o valor dessa instância em um String.
ToString(Int32, Int32)	Converte o valor de uma subcadeia de caracteres dessa instância em um String.

Implantações explícitas de interface

Nome	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Popula um SerializationInfo objeto com os dados necessários para desserializar o objeto atual StringBuilder .

Confira também

• String