StringBuilder Constructores

Definición

Espacio de nombres:

System.Text

Ensamblado:

System.Runtime.dll

Inicializa una nueva instancia de la clase StringBuilder.

Sobrecargas

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 capacidad y la cadena especificadas.
StringBuilder(String, Int32, Int32, Int32)	Inicializa una nueva instancia de la clase StringBuilder 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 = gcnew StringBuilder;

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

Comentarios

El valor de cadena de esta instancia se establece en y la capacidad se establece String.Emptyen la capacidad predeterminada específica de la implementación.

StringBuilder(Int32)

Source:

StringBuilder.cs

Inicializa una nueva instancia de la clase StringBuilder con 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

Sugerencia de tamaño inicial de la 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 = gcnew StringBuilder( capacity );

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 almacenarán 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 clase StringBuilder con 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 (o sea, Empty).

Ejemplos

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

String^ initialString = L"Initial string.";
StringBuilder^ stringBuilder = gcnew StringBuilder( initialString );

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 (o sea, Empty).

StringBuilder(Int32, Int32)

Source:

StringBuilder.cs

Inicializa una nueva instancia de la clase StringBuilder que empieza con una capacidad concreta y puede aumentar 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

Sugerencia de tamaño inicial de StringBuilder.

maxCapacity

Int32

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 especificada y una capacidad máxima.

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

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 almacenarán 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 almacenarán 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 una instancia 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 clase StringBuilder con la capacidad y la cadena 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 (o sea, Empty).

capacity

Int32

Sugerencia de tamaño inicial 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 = 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);

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 almacenarán 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 clase StringBuilder 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 que se usa para inicializar el valor de esta instancia. Si value es null, el nuevo StringBuilder contendrá la cadena vacía (o sea, Empty).

startIndex

Int32

Posición de value en la que comienza la subcadena.

length

Int32

Número de caracteres de la subcadena.

capacity

Int32

Sugerencia de tamaño inicial de StringBuilder.

Excepciones

ArgumentOutOfRangeException

capacity es menor que cero.

o bien

startIndex más 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 = 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);

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 almacenarán 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