Representa una cadena de caracteres modificable. Esta clase no puede heredarse.
Ensamblado: mscorlib (en mscorlib.dll)
<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
endEl tipo StringBuilder expone los siguientes miembros.
| Nombre | Descripción | |
|---|---|---|
![]() ![]() ![]() | StringBuilder | Inicializa una nueva instancia de la clase StringBuilder. |
![]() ![]() ![]() | StringBuilder(Int32) | Inicializa una nueva instancia de la clase StringBuilder con la capacidad especificada. |
![]() ![]() ![]() | StringBuilder(String) | Inicializa una nueva instancia de la clase StringBuilder con la cadena especificada. |
![]() ![]() ![]() | StringBuilder(Int32, Int32) | Inicializa una nueva instancia de la clase StringBuilder que empieza con una capacidad concreta y puede aumentar hasta un máximo especificado. |
![]() ![]() ![]() | StringBuilder(String, Int32) | Inicializa una nueva instancia de la clase StringBuilder con la cadena y capacidad especificadas. |
![]() ![]() ![]() | StringBuilder(String, Int32, Int32, Int32) | Inicializa una nueva instancia de la clase StringBuilder a partir de la subcadena y capacidad especificadas. |
| Nombre | Descripción | |
|---|---|---|
![]() ![]() ![]() | Capacity | Obtiene o establece el número máximo de caracteres que puede contener la memoria asignada por la instancia en uso. |
![]() ![]() ![]() | Chars | Obtiene o establece el carácter en la posición de carácter especificada en la instancia. |
![]() ![]() ![]() | Length | Obtiene o establece la longitud del objeto StringBuilder actual. |
![]() | MaxCapacity | Obtiene la capacidad máxima de la instancia. |
| Nombre | Descripción | |
|---|---|---|
![]() ![]() ![]() | Append(Boolean) | Anexa a esta instancia la representación en forma de cadena de un valor booleano especificado. |
![]() ![]() ![]() | Append(Byte) | Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 8 bits especificado. |
![]() ![]() ![]() | Append(Char) | Anexa a esta instancia la representación en forma de cadena de un carácter Unicode especificado. |
![]() ![]() ![]() | Append( | Anexa a esta instancia la representación en forma de cadena de los caracteres Unicode de una matriz especificada. |
![]() | Append(Decimal) | Anexa a esta instancia la representación en forma de cadena de un número decimal especificado. |
![]() ![]() ![]() | Append(Double) | Anexa a esta instancia la representación en forma de cadena de un número de punto flotante de precisión doble especificado. |
![]() ![]() ![]() | Append(Int16) | Anexa a esta instancia la representación en forma de cadena de un entero con signo de 16 bits especificado. |
![]() ![]() ![]() | Append(Int32) | Anexa a esta instancia la representación en forma de cadena de un entero con signo de 32 bits especificado. |
![]() ![]() ![]() | Append(Int64) | Anexa a esta instancia la representación en forma de cadena de un entero con signo de 64 bits especificado. |
![]() ![]() ![]() | Append(Object) | Anexa a esta instancia la representación en forma de cadena de un objeto especificado. |
![]() ![]() ![]() | Append(SByte) | Anexa a esta instancia la representación en forma de cadena de un entero con signo de 8 bits especificado. |
![]() ![]() ![]() | Append(Single) | Anexa a esta instancia la representación en forma de cadena de un número de punto flotante de precisión sencilla especificado. |
![]() ![]() ![]() | Append(String) | Anexa a esta instancia una copia de la cadena especificada. |
![]() ![]() ![]() | Append(UInt16) | Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 16 bits especificado. |
![]() ![]() ![]() | Append(UInt32) | Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 32 bits especificado. |
![]() ![]() ![]() | Append(UInt64) | Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 64 bits especificado. |
![]() ![]() ![]() | Append(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. |
![]() ![]() ![]() | Append( | Anexa a esta instancia la representación en forma de cadena de una submatriz de caracteres Unicode especificados. |
![]() ![]() ![]() | Append(String, Int32, Int32) | Anexa a esta instancia una copia de una subcadena especificada. |
![]() | AppendFormat(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. |
![]() ![]() ![]() | AppendFormat(String, | 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. |
![]() ![]() ![]() | AppendFormat(IFormatProvider, String, | 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. |
![]() | AppendFormat(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. |
![]() | AppendFormat(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. |
![]() ![]() ![]() | AppendLine | Anexa el terminador de línea predeterminado al final del objeto StringBuilder actual. |
![]() ![]() ![]() | AppendLine(String) | Anexa una copia de la cadena especificada seguida del terminador de línea predeterminado al final del objeto StringBuilder actual. |
![]() | Clear | Quita todos los caracteres de la instancia de StringBuilder actual. |
![]() | CopyTo | Copia los caracteres de un segmento especificado de esta instancia al segmento especificado de una matriz Char de destino. |
![]() ![]() ![]() | EnsureCapacity | Garantiza que la capacidad de la instancia de StringBuilder corresponde como mínimo al valor especificado. |
![]() ![]() ![]() | Equals(Object) | Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object). |
![]() ![]() ![]() | Equals(StringBuilder) | Devuelve un valor que indica si esta instancia equivale a un objeto especificado. |
![]() ![]() ![]() | Finalize | 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). |
![]() ![]() ![]() | GetHashCode | Actúa como función hash para un tipo concreto. (Se hereda de Object). |
![]() ![]() ![]() | GetType | Obtiene el objeto Type de la instancia actual. (Se hereda de Object). |
![]() | Insert(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. |
![]() | Insert(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. |
![]() | Insert(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. |
![]() ![]() ![]() | Insert(Int32, | 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. |
![]() | Insert(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. |
![]() | Insert(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. |
![]() | Insert(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. |
![]() | Insert(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. |
![]() | Insert(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. |
![]() | Insert(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. |
![]() | Insert(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. |
![]() | Insert(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. |
![]() ![]() ![]() | Insert(Int32, String) | Inserta una cadena en la instancia en la posición del carácter que se haya especificado. |
![]() | Insert(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. |
![]() | Insert(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. |
![]() | Insert(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. |
![]() ![]() ![]() | Insert(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. |
![]() ![]() ![]() | Insert(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. |
![]() ![]() ![]() | MemberwiseClone | Crea una copia superficial del objeto Object actual. (Se hereda de Object). |
![]() ![]() ![]() | Remove | Elimina de la instancia el intervalo de caracteres especificado. |
![]() ![]() ![]() | Replace(Char, Char) | Reemplaza todas las apariciones de un carácter especificado en la instancia por otro carácter especificado. |
![]() ![]() ![]() | Replace(String, String) | Reemplaza todas las apariciones de una cadena especificada en la instancia por otra cadena especificada. |
![]() ![]() ![]() | Replace(Char, Char, Int32, Int32) | En una subcadena de la instancia, reemplaza todas las apariciones de un carácter especificado por otro carácter especificado. |
![]() ![]() ![]() | Replace(String, String, Int32, Int32) | En una subcadena de la instancia, reemplaza todas las apariciones de una cadena especificada por otra cadena especificada. |
![]() ![]() ![]() | ToString | Convierte el valor de la instancia en un objeto String. (Invalida a Object |
![]() ![]() ![]() | ToString(Int32, Int32) | Convierte el valor de una subcadena de la instancia en un objeto String. |
| Nombre | Descripción | |
|---|---|---|
![]() ![]() | ISerializable | Infraestructura. Rellena un objeto System.Runtime.Serialization |
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.
La capacidad predeterminada para esta implementación es 16, y la capacidad máxima predeterminada es Int32
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.
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
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..gif)
.gif)
.gif)
.gif)
.gif)
.gif)
.gif)