StringBuilder Clase

Definición

Espacio de nombres:

System.Text

Ensamblado:

mscorlib.dll

Representa una cadena mutable de caracteres. Esta clase no puede heredarse.

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

Herencia

Object

StringBuilder

Atributos

SerializableAttribute ComVisibleAttribute

Implementaciones

ISerializable

Ejemplos

En el ejemplo siguiente se muestra cómo llamar a muchos de los métodos definidos por la StringBuilder clase .

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

Comentarios

Para obtener más información sobre esta API, consulte Comentarios de API complementarios para StringBuilder.

Notas a los autores de las llamadas

En .NET Core y en .NET Framework 4.0 y versiones posteriores, al crear instancias del objeto StringBuilder llamando al constructor StringBuilder(Int32, Int32), tanto la longitud como la capacidad de la instancia de StringBuilder pueden crecer más allá del valor de su propiedad MaxCapacity. Esto puede ocurrir especialmente cuando se llama a los Append(String) métodos y AppendFormat(String, Object) para anexar cadenas pequeñas.

Constructores

Nombre	Description
StringBuilder()	Inicializa una nueva instancia de la clase StringBuilder.
StringBuilder(Int32, Int32)	Inicializa una nueva instancia de la StringBuilder clase que comienza con una capacidad especificada y puede crecer hasta un máximo especificado.
StringBuilder(Int32)	Inicializa una nueva instancia de la StringBuilder clase utilizando la capacidad especificada.
StringBuilder(String, Int32, Int32, Int32)	Inicializa una nueva instancia de la StringBuilder clase a partir de la subcadena y la capacidad especificadas.
StringBuilder(String, Int32)	Inicializa una nueva instancia de la StringBuilder clase utilizando la cadena y la capacidad especificadas.
StringBuilder(String)	Inicializa una nueva instancia de la StringBuilder clase utilizando la cadena especificada.

Propiedades

Nombre	Description
Capacity	Obtiene o establece el número máximo de caracteres que se pueden contener en la memoria asignada por la instancia actual.
Chars[Int32]	Obtiene o establece el carácter en la posición de carácter especificada en esta instancia.
Length	Obtiene o establece la longitud del objeto actual StringBuilder .
MaxCapacity	Obtiene la capacidad máxima de esta instancia.

Métodos

Nombre	Description
Append(Boolean)	Anexa la representación de cadena de un valor booleano especificado a esta instancia.
Append(Byte)	Anexa la representación de cadena de un entero de 8 bits sin signo especificado a esta instancia.
Append(Char, Int32)	Anexa un número especificado de copias de la representación de cadena de un carácter Unicode a esta instancia.
Append(Char)	Anexa la representación de cadena de un objeto especificado Char a esta instancia.
Append(Char[], Int32, Int32)	Anexa la representación de cadena de una subbarray especificada de caracteres Unicode a esta instancia.
Append(Char[])	Anexa la representación de cadena de los caracteres Unicode de una matriz especificada a esta instancia.
Append(Char*, Int32)	Anexa una matriz de caracteres Unicode a partir de una dirección especificada a esta instancia.
Append(Decimal)	Anexa la representación de cadena de un número decimal especificado a esta instancia.
Append(Double)	Anexa la representación de cadena de un número de punto flotante de precisión doble especificado a esta instancia.
Append(Int16)	Anexa la representación de cadena de un entero de 16 bits con signo especificado a esta instancia.
Append(Int32)	Anexa la representación de cadena de un entero de 32 bits con signo especificado a esta instancia.
Append(Int64)	Anexa la representación de cadena de un entero de 64 bits con signo especificado a esta instancia.
Append(Object)	Anexa la representación de cadena de un objeto especificado a esta instancia.
Append(SByte)	Anexa la representación de cadena de un entero de 8 bits con signo especificado a esta instancia.
Append(Single)	Anexa la representación de cadena de un número de punto flotante de precisión sencilla especificado a esta instancia.
Append(String, Int32, Int32)	Anexa una copia de una subcadena especificada a esta instancia.
Append(String)	Anexa una copia de la cadena especificada a esta instancia.
Append(UInt16)	Anexa la representación de cadena de un entero de 16 bits sin signo especificado a esta instancia.
Append(UInt32)	Anexa la representación de cadena de un entero de 32 bits sin signo especificado a esta instancia.
Append(UInt64)	Anexa la representación de cadena de un entero de 64 bits sin signo especificado a esta instancia.
AppendFormat(IFormatProvider, String, Object, Object, Object)	Anexa la cadena devuelta mediante el procesamiento de una cadena de formato compuesto, que contiene cero o más elementos de formato, a esta instancia. Cada elemento de formato se reemplaza por la representación de cadena de cualquiera de los tres argumentos mediante un proveedor de formato especificado.
AppendFormat(IFormatProvider, String, Object, Object)	Anexa la cadena devuelta mediante el procesamiento de una cadena de formato compuesto, que contiene cero o más elementos de formato, a esta instancia. Cada elemento de formato se reemplaza por la representación de cadena de cualquiera de los dos argumentos mediante un proveedor de formato especificado.
AppendFormat(IFormatProvider, String, Object)	Anexa la cadena devuelta mediante el procesamiento de una cadena de formato compuesto, que contiene cero o más elementos de formato, a esta instancia. Cada elemento de formato se reemplaza por la representación de cadena de un único argumento mediante un proveedor de formato especificado.
AppendFormat(IFormatProvider, String, Object[])	Anexa la cadena devuelta mediante el procesamiento de una cadena de formato compuesto, que contiene cero o más elementos de formato, a esta instancia. Cada elemento de formato se reemplaza por la representación de cadena de un argumento correspondiente en una matriz de parámetros mediante un proveedor de formato especificado.
AppendFormat(String, Object, Object, Object)	Anexa la cadena devuelta mediante el procesamiento de una cadena de formato compuesto, que contiene cero o más elementos de formato, a esta instancia. Cada elemento de formato se reemplaza por la representación de cadena de cualquiera de los tres argumentos.
AppendFormat(String, Object, Object)	Anexa la cadena devuelta mediante el procesamiento de una cadena de formato compuesto, que contiene cero o más elementos de formato, a esta instancia. Cada elemento de formato se reemplaza por la representación de cadena de cualquiera de los dos argumentos.
AppendFormat(String, Object)	Anexa la cadena devuelta mediante el procesamiento de una cadena de formato compuesto, que contiene cero o más elementos de formato, a esta instancia. Cada elemento de formato se reemplaza por la representación de cadena de un único argumento.
AppendFormat(String, Object[])	Anexa la cadena devuelta mediante el procesamiento de una cadena de formato compuesto, que contiene cero o más elementos de formato, a esta instancia. Cada elemento de formato se reemplaza por la representación de cadena de un argumento correspondiente en una matriz de parámetros.
AppendLine()	Anexa el terminador de línea predeterminado al final del objeto actual StringBuilder .
AppendLine(String)	Anexa una copia de la cadena especificada seguida del terminador de línea predeterminado al final del objeto actual StringBuilder .
Clear()	Quita todos los caracteres de la instancia actual StringBuilder .
CopyTo(Int32, Char[], Int32, Int32)	Copia los caracteres de un segmento especificado de esta instancia en un segmento especificado de una matriz de destino Char .
EnsureCapacity(Int32)	Garantiza que la capacidad de esta instancia de StringBuilder sea al menos el valor especificado.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
Equals(StringBuilder)	Devuelve un valor que indica si esta instancia es igual a un objeto especificado.
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Insert(Int32, Boolean)	Inserta la representación de cadena de un valor booleano en esta instancia en la posición de carácter especificada.
Insert(Int32, Byte)	Inserta la representación de cadena de un entero de 8 bits sin signo especificado en esta instancia en la posición de carácter especificada.
Insert(Int32, Char)	Inserta la representación de cadena de un carácter Unicode especificado en esta instancia en la posición de carácter especificada.
Insert(Int32, Char[], Int32, Int32)	Inserta la representación de cadena de una subbarray especificada de caracteres Unicode en esta instancia en la posición de carácter especificada.
Insert(Int32, Char[])	Inserta la representación de cadena de una matriz especificada de caracteres Unicode en esta instancia en la posición de carácter especificada.
Insert(Int32, Decimal)	Inserta la representación de cadena de un número decimal en esta instancia en la posición de carácter especificada.
Insert(Int32, Double)	Inserta la representación de cadena de un número de punto flotante de precisión doble en esta instancia en la posición de carácter especificada.
Insert(Int32, Int16)	Inserta la representación de cadena de un entero con signo de 16 bits especificado en esta instancia en la posición de carácter especificada.
Insert(Int32, Int32)	Inserta la representación de cadena de un entero de 32 bits con signo especificado en esta instancia en la posición de carácter especificada.
Insert(Int32, Int64)	Inserta la representación de cadena de un entero con signo de 64 bits en esta instancia en la posición de carácter especificada.
Insert(Int32, Object)	Inserta la representación de cadena de un objeto en esta instancia en la posición de carácter especificada.
Insert(Int32, SByte)	Inserta la representación de cadena de un entero con signo de 8 bits especificado en esta instancia en la posición de carácter especificada.
Insert(Int32, Single)	Inserta la representación de cadena de un número de punto flotante de precisión sencilla en esta instancia en la posición de carácter especificada.
Insert(Int32, String, Int32)	Inserta una o varias copias de una cadena especificada en esta instancia en la posición de carácter especificada.
Insert(Int32, String)	Inserta una cadena en esta instancia en la posición de carácter especificada.
Insert(Int32, UInt16)	Inserta la representación de cadena de un entero de 16 bits sin signo en esta instancia en la posición de carácter especificada.
Insert(Int32, UInt32)	Inserta la representación de cadena de un entero de 32 bits sin signo en esta instancia en la posición de carácter especificada.
Insert(Int32, UInt64)	Inserta la representación de cadena de un entero de 64 bits sin signo en esta instancia en la posición de carácter especificada.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
Remove(Int32, Int32)	Quita el intervalo de caracteres especificado de esta instancia.
Replace(Char, Char, Int32, Int32)	Reemplaza, dentro de una subcadena de esta instancia, todas las apariciones de un carácter especificado por otro carácter especificado.
Replace(Char, Char)	Reemplaza todas las apariciones de un carácter especificado en esta instancia por otro carácter especificado.
Replace(String, String, Int32, Int32)	Reemplaza, dentro de una subcadena de esta instancia, todas las apariciones de una cadena especificada por otra cadena especificada.
Replace(String, String)	Reemplaza todas las apariciones de una cadena especificada en esta instancia por otra cadena especificada.
ToString()	Convierte el valor de esta instancia en .String
ToString(Int32, Int32)	Convierte el valor de una subcadena de esta instancia en .String

Implementaciones de interfaz explícitas

Nombre	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Rellena un SerializationInfo objeto con los datos necesarios para deserializar el objeto actual StringBuilder .

Consulte también

• String