StringBuilder Constructores

Definición

Espacio de nombres:

System.Text

Ensamblados:

netstandard.dll, System.Runtime.dll

Inicializa una nueva instancia de la clase StringBuilder.

Sobrecargas

Nombre	Description
StringBuilder()	Inicializa una nueva instancia de la clase StringBuilder.
StringBuilder(Int32)	Inicializa una nueva instancia de la StringBuilder clase utilizando la capacidad especificada.
StringBuilder(String)	Inicializa una nueva instancia de la StringBuilder clase utilizando la cadena especificada.
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(String, Int32)	Inicializa una nueva instancia de la StringBuilder clase utilizando la cadena y la capacidad especificadas.
StringBuilder(String, Int32, Int32, Int32)	Inicializa una nueva instancia de la StringBuilder clase a partir de la subcadena y la capacidad especificadas.

StringBuilder()

Source:

StringBuilder.cs

Inicializa una nueva instancia de la clase StringBuilder.

public:
 StringBuilder();

public StringBuilder();

Public Sub New ()

Ejemplos

En el ejemplo siguiente se muestra cómo llamar al StringBuilder constructor sin parámetros.

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = 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.

StringBuilder(Int32)

Source:

StringBuilder.cs

Inicializa una nueva instancia de la StringBuilder clase utilizando la capacidad especificada.

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

Tamaño inicial sugerido de esta instancia.

Excepciones

ArgumentOutOfRangeException

capacity es menor que cero.

Ejemplos

En el ejemplo siguiente se muestra cómo llamar al StringBuilder constructor con una capacidad especificada.

int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(capacity);

let capacity = 255
let stringBuilder = 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. Su valor se asigna a la Capacity propiedad . Si el número de caracteres que se van a almacenar en la instancia actual supera este capacity valor, el StringBuilder objeto asigna memoria adicional para almacenarlos.

El valor de cadena de esta instancia se establece en String.Empty. Si capacity es cero, se usa la capacidad predeterminada específica de la implementación.

Consulte también

• Capacity

StringBuilder(String)

Source:

StringBuilder.cs

Inicializa una nueva instancia de la StringBuilder clase utilizando la cadena especificada.

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

Cadena usada para inicializar el valor de la instancia. Si value es null, el nuevo StringBuilder contendrá la cadena vacía (es decir, contiene Empty).

Ejemplos

En el ejemplo siguiente se muestra cómo llamar al StringBuilder constructor con la cadena especificada.

string initialString = "Initial string.";
StringBuilder stringBuilder = new StringBuilder(initialString);

let initialString = "Initial string."
let stringBuilder = 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 (es decir, contiene Empty).

StringBuilder(Int32, Int32)

Source:

StringBuilder.cs

Inicializa una nueva instancia de la StringBuilder clase que comienza con una capacidad especificada y puede crecer hasta un máximo especificado.

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

Tamaño inicial sugerido de .StringBuilder

maxCapacity

Int32

El número máximo de caracteres que puede contener la cadena actual.

Excepciones

ArgumentOutOfRangeException

maxCapacity es menor que uno, capacity es menor que cero o capacity es mayor que maxCapacity.

Ejemplos

En el ejemplo siguiente se muestra cómo llamar al StringBuilder constructor con una capacidad y capacidad máxima especificadas.

int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new StringBuilder(capacity, maxCapacity);

let capacity = 255
let maxCapacity = 1024
let stringBuilder = 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. Su valor se asigna a la Capacity propiedad . Si el número de caracteres que se van a almacenar en la instancia actual supera este capacity valor, el StringBuilder objeto asigna memoria adicional para almacenarlos.

Si capacity es cero, se usa la capacidad predeterminada específica de la implementación.

La maxCapacity propiedad define el número máximo de caracteres que puede contener la instancia actual. Su valor se asigna a la MaxCapacity propiedad . Si el número de caracteres que se van a almacenar en la instancia actual supera este maxCapacity valor, el StringBuilder objeto no asigna memoria adicional, sino que produce una excepción.

Notas a los autores de las llamadas

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

Consulte también

• Capacity
• MaxCapacity

StringBuilder(String, Int32)

Source:

StringBuilder.cs

Inicializa una nueva instancia de la StringBuilder clase utilizando la cadena y la capacidad especificadas.

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

Cadena usada para inicializar el valor de la instancia. Si value es null, el nuevo StringBuilder contendrá la cadena vacía (es decir, contiene Empty).

capacity

Int32

Tamaño inicial sugerido de .StringBuilder

Excepciones

ArgumentOutOfRangeException

capacity es menor que cero.

Ejemplos

En el ejemplo siguiente se muestra cómo llamar al StringBuilder constructor con una cadena inicial y una capacidad especificada.

string initialString = "Initial string. ";
int capacity = 255;
StringBuilder stringBuilder = 
    new StringBuilder(initialString, capacity);

let initialString = "Initial string. "
let capacity = 255
let stringBuilder = 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. Su valor se asigna a la Capacity propiedad . Si el número de caracteres que se van a almacenar en la instancia actual supera este capacity valor, el StringBuilder objeto asigna memoria adicional para almacenarlos.

Si capacity es cero, se usa la capacidad predeterminada específica de la implementación.

Consulte también

• Capacity

StringBuilder(String, Int32, Int32, Int32)

Source:

StringBuilder.cs

Inicializa una nueva instancia de la StringBuilder clase a partir de la subcadena y la capacidad especificadas.

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

Cadena que contiene la subcadena utilizada para inicializar el valor de esta instancia. Si value es null, el nuevo StringBuilder contendrá la cadena vacía (es decir, contiene Empty).

startIndex

Int32

Posición dentro de value donde comienza la subcadena.

length

Int32

Número de caracteres de la subcadena.

capacity

Int32

Tamaño inicial sugerido de .StringBuilder

Excepciones

ArgumentOutOfRangeException

capacity es menor que cero.

O bien

startIndex plus length no es una posición dentro de value.

Ejemplos

En el ejemplo siguiente se muestra cómo llamar al StringBuilder constructor con la cadena especificada.

string initialString = "Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(initialString, 
    startIndex, substringLength, capacity);

let initialString = "Initial string for stringbuilder."
let startIndex = 0
let substringLength = 14
let capacity = 255

let stringBuilder =
    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. Su valor se asigna a la Capacity propiedad . Si el número de caracteres que se van a almacenar en la instancia actual supera este capacity valor, el StringBuilder objeto asigna memoria adicional para almacenarlos.

Si capacity es cero, se usa la capacidad predeterminada específica de la implementación.

Consulte también

• Capacity