El constructor StringBuilder(Int32) se usa para inicializar una nueva instancia de la clase StringBuilder que estará vacía y tendrá la capacidad inicial especificada. StringBuilder se utiliza para representar una string mutable de caracteres. Mutable significa la string que se puede cambiar. Entonces, los objetos String son inmutables, pero StringBuilder es el tipo de string mutable. No creará una nueva instancia modificada del objeto de string actual, pero hará las modificaciones en el objeto de string existente.
Sintaxis:
public StringBuilder (int capacity);
Aquí, la capacidad es el tamaño inicial de la instancia de StringBuilder. Si la cantidad de caracteres que se van a almacenar supera la capacidad especificada, el objeto StringBuilder asignará dinámicamente la memoria para almacenarlos.
Excepción: Esto dará ArgumentOutOfRangeException si la capacidad es menor que cero.
Ejemplo 1:
// C# Program to illustrate how
// to create a StringBuilder having
// specified initial capacity
using System;
using System.Text;
using System.Collections;
class Geeks {
// Main Method
public static void Main(String[] args)
{
// sb is the StringBuilder object
// StringBuilder(10) is the constructor
// used to initializes a new
// instance of the StringBuilder class
// having 10 as capacity
StringBuilder sb = new StringBuilder(10);
Console.Write("Capacity of StringBuilder: ");
// using capacity property
Console.WriteLine(sb.Capacity);
}
}
Capacity of StringBuilder: 10
Ejemplo 2: para ArgumentOutOfRangeException
// C# Program to illustrate how
// to create a StringBuilder having
// specified initial capacity
using System;
using System.Text;
using System.Collections;
class Geeks {
// Main Method
public static void Main(String[] args)
{
// sb is the StringBuilder object
// taking capacity less than zero
StringBuilder sb = new StringBuilder(-4);
// using capacity property
Console.WriteLine(sb.Capacity);
}
}
Error de tiempo de ejecución:
Excepción no controlada:
System.ArgumentOutOfRangeException: ‘capacidad’ debe ser mayor que cero.
Nombre del parámetro: capacidad
Referencia:
Publicación traducida automáticamente
Artículo escrito por ankita_saini y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA