Skip to main content
Biblioteca de clases de .NET Framework
StringBuilder (Clase)

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

Jerarquía de herencia
System..::.Object
  System.Text..::.StringBuilder

Espacio de nombres: System.Text
Ensamblado: mscorlib (en mscorlib.dll)
Sintaxis
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class StringBuilder _
	Implements ISerializable
[SerializableAttribute]
[ComVisibleAttribute(true)]
public sealed class StringBuilder : ISerializable
[SerializableAttribute]
[ComVisibleAttribute(true)]
public ref class StringBuilder sealed : ISerializable
[<Sealed>]
[<SerializableAttribute>]
[<ComVisibleAttribute(true)>]
type StringBuilder =  
    class
        interface ISerializable
    end

El tipo StringBuilder expone los siguientes miembros.

Constructores
 NombreDescripción
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifStringBuilder()()() Inicializa una nueva instancia de la clase StringBuilder.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifStringBuilder(Int32) Inicializa una nueva instancia de la clase StringBuilder con la capacidad especificada.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifStringBuilder(String) Inicializa una nueva instancia de la clase StringBuilder con la cadena especificada.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifStringBuilder(Int32, Int32) Inicializa una nueva instancia de la clase StringBuilder que empieza con una capacidad concreta y puede aumentar hasta un máximo especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifStringBuilder(String, Int32) Inicializa una nueva instancia de la clase StringBuilder con la cadena y capacidad especificadas.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifStringBuilder(String, Int32, Int32, Int32) Inicializa una nueva instancia de la clase StringBuilder a partir de la subcadena y capacidad especificadas.
Arriba
Propiedades
 NombreDescripción
Propiedad públicaCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifCapacity Obtiene o establece el número máximo de caracteres que puede contener la memoria asignada por la instancia en uso.
Propiedad públicaCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifChars Obtiene o establece el carácter en la posición de carácter especificada en la instancia.
Propiedad públicaCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifLength Obtiene o establece la longitud del objeto StringBuilder actual.
Propiedad públicaMaxCapacity Obtiene la capacidad máxima de la instancia.
Arriba
Métodos
 NombreDescripción
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(Boolean) Anexa a esta instancia la representación en forma de cadena de un valor booleano especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(Byte) Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 8 bits especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(Char) Anexa a esta instancia la representación en forma de cadena de un carácter Unicode especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(array<Char>[]()[]) Anexa a esta instancia la representación en forma de cadena de los caracteres Unicode de una matriz especificada.
Método públicoAppend(Decimal) Anexa a esta instancia la representación en forma de cadena de un número decimal especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(Double) Anexa a esta instancia la representación en forma de cadena de un número de punto flotante de precisión doble especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(Int16) Anexa a esta instancia la representación en forma de cadena de un entero con signo de 16 bits especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(Int32) Anexa a esta instancia la representación en forma de cadena de un entero con signo de 32 bits especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(Int64) Anexa a esta instancia la representación en forma de cadena de un entero con signo de 64 bits especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(Object) Anexa a esta instancia la representación en forma de cadena de un objeto especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(SByte) Anexa a esta instancia la representación en forma de cadena de un entero con signo de 8 bits especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(Single) Anexa a esta instancia la representación en forma de cadena de un número de punto flotante de precisión sencilla especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(String) Anexa a esta instancia una copia de la cadena especificada.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(UInt16) Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 16 bits especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(UInt32) Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 32 bits especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(UInt64) Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 64 bits especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(Char, Int32) Anexa a esta instancia un número especificado de copias de la representación en forma de cadena de un carácter Unicode.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(array<Char>[]()[], Int32, Int32) Anexa a esta instancia la representación en forma de cadena de una submatriz de caracteres Unicode especificados.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppend(String, Int32, Int32) Anexa a esta instancia una copia de una subcadena especificada.
Método públicoAppendFormat(String, Object) Anexa a esta instancia la cadena devuelta al procesar una cadena de formato compuesta que contiene cero o más elementos de formato. Cada elemento de formato se reemplaza por la representación en forma de cadena de un único argumento.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppendFormat(String, array<Object>[]()[]) Anexa a esta instancia la cadena devuelta al procesar una cadena de formato compuesta que contiene cero o más elementos de formato. Cada elemento de formato se reemplaza por la representación en forma de cadena de un argumento correspondiente en una matriz de parámetros.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppendFormat(IFormatProvider, String, array<Object>[]()[]) Anexa a esta instancia la cadena devuelta al procesar una cadena de formato compuesta que contiene cero o más elementos de formato. Cada elemento de formato se reemplaza por la representación en forma de cadena de un argumento correspondiente en una matriz de parámetros utilizando un proveedor de formato especificado.
Método públicoAppendFormat(String, Object, Object) Anexa a esta instancia la cadena devuelta al procesar una cadena de formato compuesta que contiene cero o más elementos de formato. Cada elemento de formato se reemplaza por la representación en forma de cadena de uno de dos argumentos.
Método públicoAppendFormat(String, Object, Object, Object) Anexa a esta instancia la cadena devuelta al procesar una cadena de formato compuesta que contiene cero o más elementos de formato. Cada elemento de formato se reemplaza por la representación en forma de cadena de uno de tres argumentos.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppendLine()()() Anexa el terminador de línea predeterminado al final del objeto StringBuilder actual.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifAppendLine(String) Anexa una copia de la cadena especificada seguida del terminador de línea predeterminado al final del objeto StringBuilder actual.
Método públicoClear Quita todos los caracteres de la instancia de StringBuilder actual.
Método públicoCopyTo Copia los caracteres de un segmento especificado de esta instancia al segmento especificado de una matriz Char de destino.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifEnsureCapacity Garantiza que la capacidad de la instancia de StringBuilder corresponde como mínimo al valor especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifEquals(Object) Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifEquals(StringBuilder) Devuelve un valor que indica si esta instancia equivale a un objeto especificado.
Método protegidoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifGetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifGetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método públicoInsert(Int32, Boolean) Inserta en la instancia la representación en forma de cadena de un valor booleano en la posición del carácter que se haya especificado.
Método públicoInsert(Int32, Byte) Inserta en la instancia la representación en forma de cadena de un entero de 8 bits sin signo, en la posición del carácter que se haya especificado.
Método públicoInsert(Int32, Char) Inserta en la instancia la representación en forma de cadena de un carácter Unicode concreto en la posición del carácter que se haya especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifInsert(Int32, array<Char>[]()[]) Inserta en la instancia la representación en forma de cadena de una matriz concreta de caracteres Unicode en la posición del carácter que se haya especificado.
Método públicoInsert(Int32, Decimal) Inserta en la instancia la representación en forma de cadena de un número decimal en la posición del carácter que se haya especificado.
Método públicoInsert(Int32, Double) Inserta en la instancia la representación en forma de cadena de un número de punto flotante de doble precisión en la posición del carácter que se haya especificado.
Método públicoInsert(Int32, Int16) Inserta en esta instancia la representación en forma de cadena de un entero de 16 bits con signo especificado, en la posición del carácter que se haya indicado.
Método públicoInsert(Int32, Int32) Inserta en esta instancia la representación en forma de cadena de un entero de 32 bits con signo especificado, en la posición del carácter que se haya indicado.
Método públicoInsert(Int32, Int64) Inserta en la instancia la representación en forma de cadena de un entero de 64 bits con signo, en la posición del carácter que se haya especificado.
Método públicoInsert(Int32, Object) Inserta en la instancia la representación en forma de cadena de un objeto en la posición del carácter que se haya especificado.
Método públicoInsert(Int32, SByte) Inserta en esta instancia la representación en forma de cadena de un entero de 8 bits con signo especificado, en la posición del carácter que se haya indicado.
Método públicoInsert(Int32, Single) Inserta en la instancia la representación en forma de cadena de un número de punto flotante de precisión sencilla en la posición del carácter que se haya especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifInsert(Int32, String) Inserta una cadena en la instancia en la posición del carácter que se haya especificado.
Método públicoInsert(Int32, UInt16) Inserta en esta instancia la representación en forma de cadena de un entero de 16 bits sin signo, en la posición del carácter que se haya especificado.
Método públicoInsert(Int32, UInt32) Inserta en esta instancia la representación en forma de cadena de un entero de 32 bits sin signo, en la posición del carácter que se haya especificado.
Método públicoInsert(Int32, UInt64) Inserta en esta instancia la representación en forma de cadena de un entero de 64 bits sin signo, en la posición del carácter que se haya especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifInsert(Int32, String, Int32) Inserta en la instancia una o más copias de una cadena concreta en la posición del carácter que se haya especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifInsert(Int32, array<Char>[]()[], Int32, Int32) Inserta en la instancia la representación en forma de cadena de una submatriz concreta de caracteres Unicode en la posición del carácter que se haya especificado.
Método protegidoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifMemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifRemove Elimina de la instancia el intervalo de caracteres especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifReplace(Char, Char) Reemplaza todas las apariciones de un carácter especificado en la instancia por otro carácter especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifReplace(String, String) Reemplaza todas las apariciones de una cadena especificada en la instancia por otra cadena especificada.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifReplace(Char, Char, Int32, Int32) En una subcadena de la instancia, reemplaza todas las apariciones de un carácter especificado por otro carácter especificado.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifReplace(String, String, Int32, Int32) En una subcadena de la instancia, reemplaza todas las apariciones de una cadena especificada por otra cadena especificada.
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifToString()()() Convierte el valor de la instancia en un objeto String. (Invalida a Object..::.ToString()()()).
Método públicoCompatible con XNA Frameworky9sxk6fy.PortableClassLibrary(es-es,VS.100).gifToString(Int32, Int32) Convierte el valor de una subcadena de la instancia en un objeto String.
Arriba
Implementaciones explícitas de interfaces
 NombreDescripción
Implementación explícita de interfacesMétodo privadoISerializable..::.GetObjectDataInfraestructura. Rellena un objeto System.Runtime.Serialization..::.SerializationInfo con los datos necesarios para deserializar el objeto StringBuilder actual.
Arriba
Comentarios

Esta clase representa una cadena como un objeto, cuyo valor es una secuencia de caracteres modificable. Se dice que el valor es modificable porque puede cambiarse una vez se ha creado mediante la adición, sustracción, sustitución o inserción de caracteres. Para comparar, vea la clase String.

La mayoría de los métodos que modifican una instancia de esta clase, devuelven una referencia a esa misma instancia. Dado que se devuelve una referencia a la instancia, se puede llamar a un método o a una propiedad en una referencia. Esto puede ser conveniente si lo que se pretende es escribir una única instrucción que encadene sucesivas operaciones.

La capacidad de un StringBuilder corresponde al mayor número de caracteres que la instancia pueda almacenar en un tiempo determinado, y es mayor o igual que la longitud de la representación de la cadena del valor de la instancia. La capacidad puede incrementarse o disminuirse mediante la propiedad Capacity o bien mediante el método EnsureCapacity pero no puede ser menor que el valor de la propiedad Length.

Se usan valores predeterminados específicos de la implementación si no se especifica la capacidad o la capacidad máxima al inicializarse una instancia de StringBuilder.

Consideraciones sobre el rendimiento

Los métodos Concat y AppendFormat concatenan los nuevos datos en un objeto String o StringBuilder existente. La operación de concatenación en un objeto String siempre crea un nuevo objeto a partir de la cadena existente y los nuevos datos. Un objeto StringBuilder mantiene un búfer para alojar la concatenación de nuevos datos. Los nuevos datos se anexan al final del búfer si hay espacio disponible; de lo contrario, se asigna un nuevo búfer más grande, los datos del búfer original se copian en el nuevo búfer y, a continuación, los nuevos datos se anexan al nuevo búfer.

El rendimiento de una operación de concatenación para un objeto String o StringBuilder depende de la frecuencia con que se produzca la asignación de memoria. La operación de concatenación en un objeto String siempre asigna memoria, mientras que la operación de concatenación en un objeto StringBuilder sólo asigna memoria si el búfer del objeto StringBuilder es demasiado pequeño para alojar los nuevos datos. Por ello, la clase String es preferible para una operación de la concatenación si un se concatena un número fijo de objetos String. En ese caso, el compilador podría combinar en una única operación cada una de las operaciones de concatenación. Los objetos StringBuilder son preferibles para las operaciones de concatenación si se concatena un número arbitrario de cadenas; por ejemplo, si un bucle concatena un número aleatorio de cadenas de datos proporcionados por el usuario.

Notas para los implementadores

La capacidad predeterminada para esta implementación es 16, y la capacidad máxima predeterminada es Int32..::.MaxValue.

StringBuilder puede asignar más memoria en la medida en que se necesite para almacenar caracteres cuando se amplía el valor de una instancia; la capacidad se ajustará en la misma medida. La cantidad de memoria asignada es específica de la implementación y se produce ArgumentOutOfRangeException o OutOfMemoryException si la cantidad de memoria necesaria es mayor que la capacidad máxima.

Por ejemplo, los métodos Append, AppendFormat, EnsureCapacity, Insert y Replace pueden aumentar el valor de una instancia.

Se puede obtener acceso a los caracteres individuales del valor de StringBuilder mediante la propiedad Chars. Las posiciones de los índices empiezan por cero.

Ejemplos

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


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


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


using namespace System;
using namespace System::Text;

int main()
{
    // Create a StringBuilder that expects to hold 50 characters.
    // Initialize the StringBuilder with "ABC".
    StringBuilder^ sb = gcnew StringBuilder("ABC", 50);

    // Append three characters (D, E, and F) to the end of the
    // StringBuilder.
    sb->Append(gcnew array<Char>{'D', 'E', 'F'});

    // Append a format string to the end of the StringBuilder.
    sb->AppendFormat("GHI{0}{1}", (Char)'J', (Char)'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

Información de versión

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Compatible con:
Plataformas

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Seguridad para subprocesos
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
Microsoft está realizando una encuesta en línea para comprender su opinión del sitio web de. Si decide participar, se le presentará la encuesta en línea cuando abandone el sitio web de.

¿Desea participar?