StringBuilder StringBuilder StringBuilder StringBuilder Constructors

Definición

Sobrecargas

StringBuilder() StringBuilder() StringBuilder()

Inicializa una nueva instancia de la clase StringBuilder.Initializes a new instance of the StringBuilder class.

StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32)

Inicializa una nueva instancia de la clase StringBuilder con la capacidad especificada.Initializes a new instance of the StringBuilder class using the specified capacity.

StringBuilder(String) StringBuilder(String) StringBuilder(String) StringBuilder(String)

Inicializa una nueva instancia de la clase StringBuilder con la cadena especificada.Initializes a new instance of the StringBuilder class using the specified string.

StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) 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.Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32)

Inicializa una nueva instancia de la clase StringBuilder con la capacidad y la cadena especificadas.Initializes a new instance of the StringBuilder class using the specified string and capacity.

StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32)

Inicializa una nueva instancia de la clase StringBuilder a partir de la subcadena y la capacidad especificadas.Initializes a new instance of the StringBuilder class from the specified substring and capacity.

StringBuilder() StringBuilder() StringBuilder()

Inicializa una nueva instancia de la clase StringBuilder.Initializes a new instance of the StringBuilder class.

public:
 StringBuilder();
public StringBuilder ();
Public Sub New ()

Ejemplos

En el ejemplo siguiente se muestra cómo llamar StringBuilder al constructor sin parámetros.The following example demonstrates how to call the StringBuilder constructor with no parameters.

StringBuilder^ stringBuilder = gcnew StringBuilder;
StringBuilder stringBuilder = new StringBuilder();
Dim stringBuilder As New StringBuilder

Comentarios

El valor de cadena de esta instancia se establece String.Emptyen y la capacidad se establece en la capacidad predeterminada específica de la implementación.The string value of this instance is set to String.Empty, and the capacity is set to the implementation-specific default capacity.

StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32)

Inicializa una nueva instancia de la clase StringBuilder con la capacidad especificada.Initializes a new instance of the StringBuilder class using the specified capacity.

public:
 StringBuilder(int capacity);
public StringBuilder (int capacity);
new System.Text.StringBuilder : int -> System.Text.StringBuilder
Public Sub New (capacity As Integer)

Parámetros

capacity
Int32 Int32 Int32 Int32

Sugerencia de tamaño inicial de la instancia.The suggested starting size of this instance.

Excepciones

Ejemplos

En el ejemplo siguiente se muestra cómo llamar StringBuilder al constructor con una capacidad especificada.The following example demonstrates how to call the StringBuilder constructor with a specified capacity.

int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity );
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(capacity);
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(capacity)

Comentarios

El capacity parámetro define el número máximo de caracteres que se pueden almacenar en la memoria asignada por la instancia actual.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Su valor se asigna a la Capacity propiedad.Its value is assigned to the Capacity property. Si el número de caracteres que se va a almacenar en la instancia actual capacity supera este valor StringBuilder , el objeto asigna memoria adicional para almacenarlos.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

El valor de cadena de esta instancia se establece String.Emptyen.The string value of this instance is set to String.Empty. Si capacity es cero, se usa la capacidad predeterminada específica de la implementación.If capacity is zero, the implementation-specific default capacity is used.

Consulte también:

StringBuilder(String) StringBuilder(String) StringBuilder(String) StringBuilder(String)

Inicializa una nueva instancia de la clase StringBuilder con la cadena especificada.Initializes a new instance of the StringBuilder class using the specified string.

public:
 StringBuilder(System::String ^ value);
public StringBuilder (string value);
new System.Text.StringBuilder : string -> System.Text.StringBuilder
Public Sub New (value As String)

Parámetros

value
String String String String

Cadena usada para inicializar el valor de la instancia.The string used to initialize the value of the instance. Si value es null, el nuevo StringBuilder contendrá la cadena vacía (o sea, Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

Ejemplos

En el ejemplo siguiente se muestra cómo llamar StringBuilder al constructor con la cadena especificada.The following example demonstrates how to call the StringBuilder constructor with the specified string.

String^ initialString = L"Initial string.";
StringBuilder^ stringBuilder = gcnew StringBuilder( initialString );
string initialString = "Initial string.";
StringBuilder stringBuilder = new StringBuilder(initialString);
Dim initialString As String = "Initial string."
Dim stringBuilder As New StringBuilder(initialString)

Comentarios

Si value es null, el nuevo StringBuilder contendrá la cadena vacía (o sea, Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) 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.Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

public:
 StringBuilder(int capacity, int maxCapacity);
public StringBuilder (int capacity, int maxCapacity);
new System.Text.StringBuilder : int * int -> System.Text.StringBuilder
Public Sub New (capacity As Integer, maxCapacity As Integer)

Parámetros

capacity
Int32 Int32 Int32 Int32

Sugerencia de tamaño inicial de StringBuilder.The suggested starting size of the StringBuilder.

maxCapacity
Int32 Int32 Int32 Int32

Número máximo de caracteres que puede contener la cadena actual.The maximum number of characters the current string can contain.

Excepciones

maxCapacity es menor que uno, capacity es menor que cero o capacity es mayor que maxCapacity.maxCapacity is less than one, capacity is less than zero, or capacity is greater than maxCapacity.

Ejemplos

En el ejemplo siguiente se muestra cómo llamar StringBuilder al constructor con una capacidad especificada y una capacidad máxima.The following example demonstrates how to call the StringBuilder constructor with a specified capacity and maximum capacity.

int capacity = 255;
int maxCapacity = 1024;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity,maxCapacity );
int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new StringBuilder(capacity, maxCapacity);
Dim capacity As Integer = 255
Dim maxCapacity As Integer = 1024
Dim stringBuilder As New StringBuilder(capacity, maxCapacity)

Comentarios

El capacity parámetro define el número máximo de caracteres que se pueden almacenar en la memoria asignada por la instancia actual.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Su valor se asigna a la Capacity propiedad.Its value is assigned to the Capacity property. Si el número de caracteres que se va a almacenar en la instancia actual capacity supera este valor StringBuilder , el objeto asigna memoria adicional para almacenarlos.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Si capacity es cero, se usa la capacidad predeterminada específica de la implementación.If capacity is zero, the implementation-specific default capacity is used.

La maxCapacity propiedad define el número máximo de caracteres que puede contener la instancia actual.The maxCapacity property defines the maximum number of characters that the current instance can hold. Su valor se asigna a la MaxCapacity propiedad.Its value is assigned to the MaxCapacity property. Si el número de caracteres que se va a almacenar en la instancia actual maxCapacity supera este valor StringBuilder , el objeto no asigna memoria adicional, sino que produce una excepción.If the number of characters to be stored in the current instance exceeds this maxCapacity value, the StringBuilder object does not allocate additional memory, but instead throws an exception.

Notas a los autores de las llamadas

En .net Core y en el .NET Framework 4,0 y versiones posteriores, cuando se crea una instancia StringBuilder del objeto llamando al StringBuilder(Int32, Int32) constructor, la longitud y la capacidad de la StringBuilder instancia pueden crecer más allá del valor de su MaxCapacity propiedad.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. Esto puede ocurrir especialmente cuando se llama a Append(String) los AppendFormat(String, Object) métodos y para anexar cadenas pequeñas.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Consulte también:

StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32)

Inicializa una nueva instancia de la clase StringBuilder con la capacidad y la cadena especificadas.Initializes a new instance of the StringBuilder class using the specified string and capacity.

public:
 StringBuilder(System::String ^ value, int capacity);
public StringBuilder (string value, int capacity);
new System.Text.StringBuilder : string * int -> System.Text.StringBuilder
Public Sub New (value As String, capacity As Integer)

Parámetros

value
String String String String

Cadena usada para inicializar el valor de la instancia.The string used to initialize the value of the instance. Si value es null, el nuevo StringBuilder contendrá la cadena vacía (o sea, Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

capacity
Int32 Int32 Int32 Int32

Sugerencia de tamaño inicial de StringBuilder.The suggested starting size of the StringBuilder.

Excepciones

Ejemplos

En el ejemplo siguiente se muestra cómo llamar StringBuilder al constructor con una cadena inicial y una capacidad especificada.The following example demonstrates how to call the StringBuilder constructor with an initial string and a specified capacity.

String^ initialString = L"Initial string. ";
int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder(
   initialString,capacity );
string initialString = "Initial string. ";
int capacity = 255;
StringBuilder stringBuilder = 
    new StringBuilder(initialString, capacity);
Dim initialString As String = "Initial string. "
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, capacity)

Comentarios

El capacity parámetro define el número máximo de caracteres que se pueden almacenar en la memoria asignada por la instancia actual.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Su valor se asigna a la Capacity propiedad.Its value is assigned to the Capacity property. Si el número de caracteres que se va a almacenar en la instancia actual capacity supera este valor StringBuilder , el objeto asigna memoria adicional para almacenarlos.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Si capacity es cero, se usa la capacidad predeterminada específica de la implementación.If capacity is zero, the implementation-specific default capacity is used.

Consulte también:

StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32)

Inicializa una nueva instancia de la clase StringBuilder a partir de la subcadena y la capacidad especificadas.Initializes a new instance of the StringBuilder class from the specified substring and capacity.

public:
 StringBuilder(System::String ^ value, int startIndex, int length, int capacity);
public StringBuilder (string value, int startIndex, int length, int capacity);
new System.Text.StringBuilder : string * int * int * int -> System.Text.StringBuilder
Public Sub New (value As String, startIndex As Integer, length As Integer, capacity As Integer)

Parámetros

value
String String String String

Cadena que contiene la subcadena que se usa para inicializar el valor de esta instancia.The string that contains the substring used to initialize the value of this instance. Si value es null, el nuevo StringBuilder contendrá la cadena vacía (o sea, Empty).If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

startIndex
Int32 Int32 Int32 Int32

Posición de value en la que comienza la subcadena.The position within value where the substring begins.

length
Int32 Int32 Int32 Int32

Número de caracteres de la subcadena.The number of characters in the substring.

capacity
Int32 Int32 Int32 Int32

Sugerencia de tamaño inicial de StringBuilder.The suggested starting size of the StringBuilder.

Excepciones

capacity es menor que cero.capacity is less than zero.

O bien-or- startIndex más length no es una posición dentro de value.startIndex plus length is not a position within value.

Ejemplos

En el ejemplo siguiente se muestra cómo llamar StringBuilder al constructor con la cadena especificada.The following example demonstrates how to call the StringBuilder constructor with the specified string.

String^ initialString = L"Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder(
   initialString,startIndex,substringLength,capacity );
string initialString = "Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(initialString, 
    startIndex, substringLength, capacity);
Dim initialString As String = "Initial string for stringbuilder."
Dim startIndex As Integer = 0
Dim substringLength As Integer = 14
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, _
    startIndex, substringLength, capacity)

Comentarios

El capacity parámetro define el número máximo de caracteres que se pueden almacenar en la memoria asignada por la instancia actual.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. Su valor se asigna a la Capacity propiedad.Its value is assigned to the Capacity property. Si el número de caracteres que se va a almacenar en la instancia actual capacity supera este valor StringBuilder , el objeto asigna memoria adicional para almacenarlos.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

Si capacity es cero, se usa la capacidad predeterminada específica de la implementación.If capacity is zero, the implementation-specific default capacity is used.

Consulte también:

Se aplica a