StringBuilder Classe

Definição

Espaço de Nomes:: System.Text

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

Assemblagem:: mscorlib.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: netstandard.dll

Importante

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

Representa uma sequência mutável de caracteres. Esta classe não pode ser herdada.

public ref class StringBuilder sealed

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

public sealed class StringBuilder

[System.Serializable]
public sealed class StringBuilder

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

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

type StringBuilder = class

[<System.Serializable>]
type StringBuilder = class

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

type StringBuilder = class
    interface ISerializable

Public NotInheritable Class StringBuilder

Public NotInheritable Class StringBuilder
Implements ISerializable

Herança: Object
StringBuilder

Atributos: SerializableAttribute ComVisibleAttribute

Implementações: ISerializable

Exemplos

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

Observações

Para mais informações sobre esta API, consulte Observações suplementares da API para o StringBuilder.

Notas para Chamadores

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

Construtores

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

Propriedades

Name	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 carácter na posição especificada neste caso.
Length	Obtém ou define o comprimento do objeto atual StringBuilder .
MaxCapacity	Atinge a capacidade máxima desta instância.

Métodos

Name	Description
Append(Boolean)	Adiciona a representação da cadeia de um valor booleano especificado a esta instância.
Append(Byte)	Adiciona a representação da cadeia de um número inteiro não assinado especificado de 8 bits a esta instância.
Append(Char, Int32)	Adiciona um número especificado de cópias da representação de cadeias de um carácter Unicode a esta instância.
Append(Char)	Adiciona a representação da cadeia de um objeto especificado Char a esta instância.
Append(Char[], Int32, Int32)	Adiciona a representação de cadeias de um subarray especificado de caracteres Unicode a esta instância.
Append(Char[])	Adiciona a representação da cadeia dos caracteres Unicode num array especificado a esta instância.
Append(Char*, Int32)	Adiciona um array de caracteres Unicode a partir de um endereço especificado a esta instância.
Append(Decimal)	Adiciona a representação da cadeia de um número decimal especificado a esta instância.
Append(Double)	Adiciona a representação da cadeia de um número de ponto flutuante de dupla precisão especificado a esta instância.
Append(Int16)	Adiciona a representação da cadeia de um inteiro com sinal especificado de 16 bits a esta instância.
Append(Int32)	Adiciona a representação da cadeia de um inteiro com sinal especificado de 32 bits a esta instância.
Append(Int64)	Adiciona a representação da cadeia de um inteiro assinado especificado de 64 bits a esta instância.
Append(Object)	Adiciona a representação da cadeia de um objeto especificado a esta instância.
Append(ReadOnlySpan<Char>)	Adiciona a representação da cadeia de caracteres de um intervalo de caracteres só de leitura especificado a esta instância.
Append(SByte)	Adiciona a representação da cadeia de um inteiro com sinal especificado de 8 bits a esta instância.
Append(Single)	Adiciona a representação da cadeia de um número de ponto flutuante de precisão simples especificado a esta instância.
Append(String, Int32, Int32)	Adiciona uma cópia de uma substring especificada a esta instância.
Append(String)	Adiciona uma cópia da string especificada a esta instância.
Append(StringBuilder, Int32, Int32)	Adiciona uma cópia de uma substring dentro de um construtor de cadeias especificado a esta instância.
Append(StringBuilder)	Acrescenta a representação de cadeias de um construtor de cadeias especificado a esta instância.
Append(UInt16)	Adiciona a representação da cadeia de um inteiro não assinado especificado de 16 bits a esta instância.
Append(UInt32)	Adiciona a representação da cadeia de um inteiro não sinalado especificado de 32 bits a esta instância.
Append(UInt64)	Adiciona a representação da cadeia de um inteiro não assinado especificado de 64 bits a esta instância.
AppendFormat(IFormatProvider, String, Object, Object, Object)	Adiciona a cadeia devolvida ao processar uma cadeia 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 strings de qualquer um de três argumentos usando um fornecedor de formato especificado.
AppendFormat(IFormatProvider, String, Object, Object)	Adiciona a cadeia devolvida ao processar uma cadeia 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 em cadeia de um de dois argumentos usando um fornecedor de formato especificado.
AppendFormat(IFormatProvider, String, Object)	Adiciona a cadeia devolvida ao processar uma cadeia 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 em cadeia de um único argumento usando um fornecedor de formato especificado.
AppendFormat(IFormatProvider, String, Object[])	Adiciona a cadeia devolvida ao processar uma cadeia 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 string de um argumento correspondente num array de parâmetros usando um fornecedor de formato especificado.
AppendFormat(String, Object, Object, Object)	Adiciona a cadeia devolvida ao processar uma cadeia 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 em cadeia de um dos três argumentos.
AppendFormat(String, Object, Object)	Adiciona a cadeia devolvida ao processar uma cadeia 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 em cadeia de qualquer um de dois argumentos.
AppendFormat(String, Object)	Adiciona a cadeia devolvida ao processar uma cadeia 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 da cadeia de um único argumento.
AppendFormat(String, Object[])	Adiciona a cadeia devolvida ao processar uma cadeia 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 em cadeia de um argumento correspondente num array de parâmetros.
AppendJoin(Char, Object[])	Concatena as representações de strings dos elementos no array fornecido de objetos, usando o separador de caracteres especificado entre cada membro, e depois anexa o resultado à instância atual do construtor de strings.
AppendJoin(Char, String[])	Concatena as cadeias do array fornecido, usando o separador de caracteres especificado entre cada cadeia, e depois anexa o resultado à instância atual do construtor de cadeias.
AppendJoin(String, Object[])	Concatena as representações das strings dos elementos no array fornecido de objetos, usando o separador especificado entre cada membro, e depois adiciona o resultado à instância atual do construtor de strings.
AppendJoin(String, String[])	Concatena as cadeias do array fornecido, usando o separador especificado entre cada cadeia, e depois anexa o resultado à instância atual do construtor de cadeias.
AppendJoin<T>(Char, IEnumerable<T>)	Concatena e acrescenta os membros de uma coleção, usando o separador de caracteres especificado entre cada membro.
AppendJoin<T>(String, IEnumerable<T>)	Concatena e acrescenta os membros de uma coleção, usando o separador especificado entre cada membro.
AppendLine()	Adiciona o terminador de linha por defeito ao final do objeto atual StringBuilder .
AppendLine(String)	Adiciona uma cópia da string 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 desta instância para um segmento especificado de um array de destino Char .
CopyTo(Int32, Span<Char>, Int32)	Copia os caracteres de um segmento especificado desta instância para um intervalo de destino Char .
EnsureCapacity(Int32)	Assegura que a capacidade desta instância de StringBuilder é pelo menos o valor especificado.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Equals(ReadOnlySpan<Char>)	Devolve um valor que indica se os caracteres neste caso são iguais aos caracteres num intervalo de caracteres só de leitura especificado.
Equals(StringBuilder)	Devolve um valor que indica se esta instância é igual a um objeto especificado.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Insert(Int32, Boolean)	Insere a representação da cadeia de um valor booleano nesta instância na posição especificada do caractere.
Insert(Int32, Byte)	Insere a representação da cadeia de um inteiro não assinado especificado de 8 bits nesta instância na posição do carácter especificada.
Insert(Int32, Char)	Insere a representação da cadeia de um carácter Unicode especificado nesta instância na posição do carácter especificada.
Insert(Int32, Char[], Int32, Int32)	Insere a representação da cadeia de um subarray especificado de caracteres Unicode nesta instância na posição especificada dos caracteres.
Insert(Int32, Char[])	Insere a representação da cadeia de um array especificado de caracteres Unicode nesta instância na posição especificada dos caracteres.
Insert(Int32, Decimal)	Insere a representação da cadeia de um número decimal nesta instância na posição especificada do carácter.
Insert(Int32, Double)	Insere a representação da string de um número de ponto flutuante de dupla precisão nesta instância na posição especificada do caractere.
Insert(Int32, Int16)	Insere a representação da cadeia de um inteiro com sinal especificado de 16 bits nesta instância na posição do carácter especificada.
Insert(Int32, Int32)	Insere a representação da string de um inteiro assinado especificado de 32 bits nesta instância na posição do carácter especificada.
Insert(Int32, Int64)	Insere a representação da cadeia de um inteiro com sinal de 64 bits nesta instância na posição especificada do caractere.
Insert(Int32, Object)	Insere a representação string de um objeto nesta instância na posição de carácter especificada.
Insert(Int32, ReadOnlySpan<Char>)	Insere a sequência de caracteres nesta instância na posição especificada do caractere.
Insert(Int32, SByte)	Insere a representação da cadeia de um inteiro com sinal especificado de 8 bits nesta instância na posição do carácter especificada.
Insert(Int32, Single)	Insere a representação da cadeia de um número de ponto flutuante de precisão simples nesta instância na posição de carácter especificada.
Insert(Int32, String, Int32)	Insere uma ou mais cópias de uma string especificada nesta instância na posição do carácter especificada.
Insert(Int32, String)	Insere uma cadeia nesta instância na posição do carácter especificada.
Insert(Int32, UInt16)	Insere a representação da cadeia de um inteiro sem sinal de 16 bits nesta instância na posição especificada do caractere.
Insert(Int32, UInt32)	Insere a representação da cadeia de um inteiro sem sinal de 32 bits nesta instância na posição especificada do carácter.
Insert(Int32, UInt64)	Insere a representação da cadeia de um inteiro sem sinal de 64 bits nesta instância na posição do carácter especificada.
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
Remove(Int32, Int32)	Remove o intervalo especificado de caracteres desta instância.
Replace(Char, Char, Int32, Int32)	Substitui, dentro de uma subcadeia desta instância, todas as ocorrências de um carácter especificado por outro carácter especificado.
Replace(Char, Char)	Substitui todas as ocorrências de um carácter especificado neste caso por outro carácter especificado.
Replace(String, String, Int32, Int32)	Substitui, dentro de uma subcadeia desta instância, todas as ocorrências de uma cadeia especificada por outra cadeia especificada.
Replace(String, String)	Substitui todas as ocorrências de uma cadeia especificada neste caso por outra cadeia especificada.
ToString()	Converte o valor desta instância para um String.
ToString(Int32, Int32)	Converte o valor de uma subcadeia desta instância para um String.

Implementações de Interface Explícita

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

Aplica-se a

Ver também

String

Comentários

Esta página foi útil?