StringBuilder Constructores

Referencia

Definición

Espacio de nombres:: System.Text

Ensamblado:: System.Runtime.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

Source:: StringBuilder.cs

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.

Se aplica a

StringBuilder(Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

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

Se aplica a

StringBuilder(String)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

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

public:
 StringBuilder(System::String ^ value);

public StringBuilder (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).

Se aplica a

StringBuilder(Int32, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

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

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

Se aplica a

StringBuilder(String, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

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);

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

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

Consulte también

Capacity

Se aplica a

StringBuilder(String, Int32, Int32, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

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);

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

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

Consulte también

Capacity

Se aplica a

Compartir a través de

StringBuilder Constructores

Definición

Sobrecargas

StringBuilder()

Ejemplos

Comentarios

Se aplica a

StringBuilder(Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StringBuilder(String)

Parámetros

Ejemplos

Comentarios

Se aplica a

StringBuilder(Int32, Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Notas a los autores de las llamadas

Consulte también

Se aplica a

StringBuilder(String, Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StringBuilder(String, Int32, Int32, Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Recursos adicionales