StringBuilder.Append Método

Referencia

Definición

Espacio de nombres:: System.Text

Ensamblado:: System.Runtime.dll

Ensamblado:: netstandard.dll

Ensamblado:: mscorlib.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í.

Anexa a esta instancia la representación en forma de cadena de un objeto especificado.

Sobrecargas

Append(StringBuilder)	Anexa a esta instancia la representación en forma de cadena de un generador de cadena especificado.
Append(StringBuilder+AppendInterpolatedStringHandler)	Anexa la cadena interpolada especificada a esta instancia.
Append(UInt16)	Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 16 bits especificado.
Append(UInt32)	Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 32 bits especificado.
Append(Char, Int32)	Anexa a esta instancia un número especificado de copias de la representación en forma de cadena de un carácter Unicode.
Append(Char[], Int32, Int32)	Anexa a esta instancia la representación en forma de cadena de una submatriz de caracteres Unicode especificada.
Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Anexa la cadena interpolada especificada a esta instancia con el formato especificado.
Append(String)	Anexa a esta instancia una copia de la cadena especificada.
Append(String, Int32, Int32)	Anexa a esta instancia una copia de una subcadena especificada.
Append(StringBuilder, Int32, Int32)	Anexa a esta instancia una copia de una subcadena dentro de un generador de cadena especificado.
Append(Char*, Int32)	Anexa a esta instancia una matriz de caracteres Unicode a partir de una dirección especificada.
Append(Single)	Anexa a esta instancia la representación en forma de cadena de un número de punto flotante de precisión sencilla especificado.
Append(UInt64)	Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 64 bits especificado.
Append(ReadOnlySpan<Char>)	Anexa a esta instancia la representación en forma de cadena de un intervalo de caracteres de solo lectura especificado.
Append(SByte)	Anexa a esta instancia la representación en forma de cadena de un entero con signo de 8 bits especificado.
Append(Boolean)	Anexa a esta instancia la representación en forma de cadena de un valor booleano especificado.
Append(Byte)	Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 8 bits especificado.
Append(Char)	Anexa a esta instancia la representación en forma de cadena de un objeto Char especificado.
Append(Decimal)	Anexa a esta instancia la representación en forma de cadena de un número decimal especificado.
Append(Double)	Anexa a esta instancia la representación en forma de cadena de un número de punto flotante de precisión doble especificado.
Append(Char[])	Anexa a esta instancia la representación en forma de cadena de los caracteres Unicode de una matriz especificada.
Append(Int16)	Anexa a esta instancia la representación en forma de cadena de un entero con signo de 16 bits especificado.
Append(Int32)	Anexa a esta instancia la representación en forma de cadena de un entero con signo de 32 bits especificado.
Append(Int64)	Anexa a esta instancia la representación en forma de cadena de un entero con signo de 64 bits especificado.
Append(Object)	Anexa a esta instancia la representación en forma de cadena de un objeto especificado.
Append(ReadOnlyMemory<Char>)	Anexa a esta instancia la representación en forma de cadena de una región de memoria de carácter de solo lectura especificado.

Append(StringBuilder)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de un generador de cadena especificado.

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value);

public System.Text.StringBuilder Append (System.Text.StringBuilder? value);

public System.Text.StringBuilder Append (System.Text.StringBuilder value);

member this.Append : System.Text.StringBuilder -> System.Text.StringBuilder

Public Function Append (value As StringBuilder) As StringBuilder

Parámetros

value: StringBuilder

Generador de cadena que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se ha completado la operación de anexado.

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

Append(StringBuilder+AppendInterpolatedStringHandler)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa la cadena interpolada especificada a esta instancia.

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);

public System.Text.StringBuilder Append (ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);

member this.Append : AppendInterpolatedStringHandler -> System.Text.StringBuilder

Public Function Append (ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Parámetros

handler: StringBuilder.AppendInterpolatedStringHandler

Cadena interpolada que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	6, 7, 8, 9

Append(UInt16)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Importante

Esta API no es conforme a CLS.

Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 16 bits especificado.

public:
 System::Text::StringBuilder ^ Append(System::UInt16 value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ushort value);

[<System.CLSCompliant(false)>]
member this.Append : uint16 -> System.Text.StringBuilder

Public Function Append (value As UShort) As StringBuilder

Parámetros

value: UInt16

Valor que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Atributos: CLSCompliantAttribute

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(UInt16) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 16-bit unsigned integer: ");
sb.Append(UInt16.MinValue).Append(" to ").Append(UInt16.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 16-bit unsigned integer: 0 to 65535

let sb = StringBuilder "The range of a 16-bit unsigned integer: "
sb.Append(UInt16.MinValue).Append(" to ").Append UInt16.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 16-bit unsigned integer: 0 to 65535

Dim sb As New System.Text.StringBuilder("The range of a 16-bit unsigned integer: ")
sb.Append(UInt16.MinValue).Append(" to ").Append(UInt16.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 16-bit unsigned integer: 0 to 65535

El Append(UInt16) método llama al UInt16.ToString(IFormatProvider) método para obtener la representación de cadena de value. Para controlar el formato de value, llame al AppendFormat método .

La capacidad de esta instancia se ajusta según sea necesario.

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

UInt16

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(UInt32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Importante

Esta API no es conforme a CLS.

Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 32 bits especificado.

public:
 System::Text::StringBuilder ^ Append(System::UInt32 value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (uint value);

[<System.CLSCompliant(false)>]
member this.Append : uint32 -> System.Text.StringBuilder

Public Function Append (value As UInteger) As StringBuilder

Parámetros

value: UInt32

Valor que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Atributos: CLSCompliantAttribute

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(UInt32) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 32-bit unsigned integer: ");
sb.Append(UInt32.MinValue).Append(" to ").Append(UInt32.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 32-bit unsigned integer: 0 to 4294967295

let sb = StringBuilder "The range of a 32-bit unsigned integer: "
sb.Append(UInt32.MinValue).Append(" to ").Append UInt32.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 32-bit unsigned integer: 0 to 4294967295

Dim sb As New System.Text.StringBuilder("The range of a 32-bit unsigned integer: ")
sb.Append(UInt32.MinValue).Append(" to ").Append(UInt32.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 32-bit unsigned integer: 0 to 4294967295

Append(UInt32) Llama al UInt32.ToString método para obtener la representación de cadena de value para la referencia cultural actual. Para controlar el formato de value, llame al AppendFormat método .

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

UInt32

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(Char, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia un número especificado de copias de la representación en forma de cadena de un carácter Unicode.

public:
 System::Text::StringBuilder ^ Append(char value, int repeatCount);

public System.Text.StringBuilder Append (char value, int repeatCount);

member this.Append : char * int -> System.Text.StringBuilder

Public Function Append (value As Char, repeatCount As Integer) As StringBuilder

Parámetros

value: Char

Carácter que se va a anexar.

repeatCount: Int32

Número de veces que se va a anexar value.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentOutOfRangeException

repeatCount es menor que cero.

o bien

Si se amplía el valor de esta instancia, se superará MaxCapacity.

OutOfMemoryException

Memoria insuficiente

Comentarios

El Append(Char, Int32) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).AppendFormat("{0:C2}", value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****$1,346.19*****

let value = 1346.19m
let sb = StringBuilder()
sb.Append('*', 5).AppendFormat("{0:C2}", value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****$1,346.19*****

Dim value As Decimal = 1346.19d
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).AppendFormat("{0:C2}", value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****$1,346.19*****

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

Char

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(Char[], Int32, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de una submatriz de caracteres Unicode especificada.

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value, int startIndex, int charCount);

public System.Text.StringBuilder Append (char[] value, int startIndex, int charCount);

public System.Text.StringBuilder Append (char[]? value, int startIndex, int charCount);

member this.Append : char[] * int * int -> System.Text.StringBuilder

Public Function Append (value As Char(), startIndex As Integer, charCount As Integer) As StringBuilder

Parámetros

value: Char[]

Matriz de caracteres.

startIndex: Int32

Posición inicial en value.

charCount: Int32

Número de caracteres que se van a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentNullException

value es null, y startIndex y charCount no son cero.

ArgumentOutOfRangeException

charCount es menor que cero.

O bien

startIndex es menor que cero.

o bien

startIndex + charCount es mayor que la longitud de value.

o bien

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

Este método anexa el intervalo de caracteres especificado en value a la instancia actual. Si value es null y startIndex son count cero, no se realizan cambios.

El Append(Char[], Int32, Int32) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

char[] chars = { 'a', 'b', 'c', 'd', 'e'};
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int startPosition = Array.IndexOf(chars, 'a');
int endPosition = Array.IndexOf(chars, 'c');
if (startPosition >= 0 && endPosition >= 0) {
   sb.Append("The array from positions ").Append(startPosition).
             Append(" to ").Append(endPosition).Append(" contains ").
             Append(chars, startPosition, endPosition + 1).Append(".");
   Console.WriteLine(sb);
}             
// The example displays the following output:
//       The array from positions 0 to 2 contains abc.

let chars = [| 'a'; 'b'; 'c'; 'd'; 'e' |]
let sb = StringBuilder()
let startPosition = Array.IndexOf(chars, 'a')
let endPosition = Array.IndexOf(chars, 'c')

if startPosition >= 0 && endPosition >= 0 then
    sb
        .Append("The array from positions ")
        .Append(startPosition)
        .Append(" to ")
        .Append(endPosition)
        .Append(" contains ")
        .Append(chars, startPosition, endPosition + 1)
        .Append "."
    |> ignore

    printfn $"{sb}"
// The example displays the following output:
//       The array from positions 0 to 2 contains abc.

Dim chars() As Char = { "a"c, "b"c, "c"c, "d"c, "e"c}
Dim sb As New System.Text.StringBuilder()
Dim startPosition As Integer = Array.IndexOf(chars, "a"c)
Dim endPosition As Integer = Array.IndexOf(chars, "c"c)
If startPosition >= 0 AndAlso endPosition >= 0 Then
   sb.Append("The array from positions ").Append(startPosition).
             Append(" to ").Append(endPosition).Append(" contains ").
             Append(chars, startPosition, endPosition + 1).Append(".")
   Console.WriteLine(sb)
End If             
' The example displays the following output:
'       The array from positions 0 to 2 contains abc.

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

Char

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa la cadena interpolada especificada a esta instancia con el formato especificado.

public:
 System::Text::StringBuilder ^ Append(IFormatProvider ^ provider, System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);

public System.Text.StringBuilder Append (IFormatProvider? provider, ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);

member this.Append : IFormatProvider * AppendInterpolatedStringHandler -> System.Text.StringBuilder

Public Function Append (provider As IFormatProvider, ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Parámetros

provider: IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

handler: StringBuilder.AppendInterpolatedStringHandler

Cadena interpolada que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	6, 7, 8, 9

Append(String)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia una copia de la cadena especificada.

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

public System.Text.StringBuilder Append (string value);

public System.Text.StringBuilder Append (string? value);

member this.Append : string -> System.Text.StringBuilder

Public Function Append (value As String) As StringBuilder

Parámetros

value: String

Cadena que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(String) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

bool flag = false;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The value of the flag is ").Append(flag).Append(".");
Console.WriteLine(sb.ToString());
// The example displays the following output:
//       The value of the flag is False.

let flag = false
let sb = StringBuilder()
sb.Append("The value of the flag is ").Append(flag).Append "." |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The value of the flag is False.

Dim flag As Boolean = false
Dim sb As New System.Text.StringBuilder
sb.Append("The value of the flag is ").Append(flag).Append(".")
Console.WriteLine(sb.ToString())
' The example displays the following output:
'       The value of the flag is False.

Si value es null, no se realizan cambios.

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

String

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(String, Int32, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia una copia de una subcadena especificada.

public:
 System::Text::StringBuilder ^ Append(System::String ^ value, int startIndex, int count);

public System.Text.StringBuilder Append (string value, int startIndex, int count);

public System.Text.StringBuilder Append (string? value, int startIndex, int count);

member this.Append : string * int * int -> System.Text.StringBuilder

Public Function Append (value As String, startIndex As Integer, count As Integer) As StringBuilder

Parámetros

value: String

Cadena que contiene la subcadena que se va a anexar.

startIndex: Int32

Posición inicial de la subcadena dentro de value.

count: Int32

Número de caracteres de value que se van a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentNullException

value es null, y startIndex y count no son cero.

ArgumentOutOfRangeException

count es menor que cero.

O bien

startIndex es menor que cero.

o bien

startIndex + count es mayor que la longitud de value.

o bien

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

Este método anexa el intervalo de caracteres especificado en value a la instancia actual. Si value es null y startIndex son count cero, no se realizan cambios.

El Append(String, Int32, Int32) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

string str = "First;George Washington;1789;1797";
int index = 0;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int length = str.IndexOf(';', index);      
sb.Append(str, index, length).Append(" President of the United States: ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(", from ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(" to ");
index += length + 1;
sb.Append(str, index, str.Length - index);
Console.WriteLine(sb);
// The example displays the following output:
//    First President of the United States: George Washington, from 1789 to 1797

let str = "First;George Washington;1789;1797"
let mutable index = 0
let sb = StringBuilder()
let length = str.IndexOf(';', index)

sb.Append(str, index, length).Append " President of the United States: "
|> ignore

index <- index + length + 1
let length = str.IndexOf(';', index) - index
sb.Append(str, index, length).Append ", from " |> ignore
index <- index + length + 1
let length = str.IndexOf(';', index) - index
sb.Append(str, index, length).Append " to " |> ignore
index <- index + length + 1
sb.Append(str, index, str.Length - index) |> ignore
printfn $"{sb}"
// The example displays the following output:
//    First President of the United States: George Washington, from 1789 to 1797

Dim str As String = "First;George Washington;1789;1797"
Dim index As Integer = 0
Dim sb As New System.Text.StringBuilder()
Dim length As Integer = str.IndexOf(";"c, index)      
sb.Append(str, index, length).Append(" President of the United States: ")
index += length + 1
length = str.IndexOf(";"c, index) - index
sb.Append(str, index, length).Append(", from ")
index += length + 1
length = str.IndexOf(";"c, index) - index
sb.Append(str, index, length).Append(" to ")
index += length + 1
sb.Append(str, index, str.Length - index)
Console.WriteLine(sb)
' The example displays the following output:
'    First President of the United States: George Washington, from 1789 to 1797

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

String

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(StringBuilder, Int32, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia una copia de una subcadena dentro de un generador de cadena especificado.

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value, int startIndex, int count);

public System.Text.StringBuilder Append (System.Text.StringBuilder? value, int startIndex, int count);

public System.Text.StringBuilder Append (System.Text.StringBuilder value, int startIndex, int count);

member this.Append : System.Text.StringBuilder * int * int -> System.Text.StringBuilder

Public Function Append (value As StringBuilder, startIndex As Integer, count As Integer) As StringBuilder

Parámetros

value: StringBuilder

Generador de cadena que contiene la subcadena que se va a anexar.

startIndex: Int32

Posición inicial de la subcadena dentro de value.

count: Int32

Número de caracteres de value que se van a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

Append(Char*, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Importante

Esta API no es conforme a CLS.

Alternativa conforme a CLS: System.Text.StringBuilder.Append(Char[], Int32, Int32)

Anexa a esta instancia una matriz de caracteres Unicode a partir de una dirección especificada.

public:
 System::Text::StringBuilder ^ Append(char* value, int valueCount);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public System.Text.StringBuilder Append (char* value, int valueCount);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (char* value, int valueCount);

[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder

[<System.CLSCompliant(false)>]
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder

Parámetros

value: Char*

Puntero a una matriz de caracteres Unicode.

valueCount: Int32

Número de caracteres de la matriz.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Atributos: CLSCompliantAttribute SecurityCriticalAttribute

Excepciones

ArgumentOutOfRangeException

valueCount es menor que cero.

o bien

Si se amplía el valor de esta instancia, se superará MaxCapacity.

NullReferenceException

value es un puntero nulo.

Comentarios

Este método anexa valueCount caracteres a partir de la dirección value a la instancia actual.

El Append(Char*, Int32) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto .

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(Single)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de un número de punto flotante de precisión sencilla especificado.

public:
 System::Text::StringBuilder ^ Append(float value);

public System.Text.StringBuilder Append (float value);

member this.Append : single -> System.Text.StringBuilder

Public Function Append (value As Single) As StringBuilder

Parámetros

value: Single

Valor que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(Single) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

float value = 1034769.47f;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1034769.47*****

let value = 1034769.47f
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1034769.47*****

Dim value As Single = 1034769.47
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1034769.47*****

El Append(Single) método llama al Single.ToString método para obtener la representación de cadena de value para la referencia cultural actual. Para controlar el formato de value, llame al AppendFormat método .

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

Single

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(UInt64)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Importante

Esta API no es conforme a CLS.

Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 64 bits especificado.

public:
 System::Text::StringBuilder ^ Append(System::UInt64 value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ulong value);

[<System.CLSCompliant(false)>]
member this.Append : uint64 -> System.Text.StringBuilder

Public Function Append (value As ULong) As StringBuilder

Parámetros

value: UInt64

Valor que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Atributos: CLSCompliantAttribute

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(UInt64) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 64-bit unsigned integer: ");
sb.Append(UInt64.MinValue).Append(" to ").Append(UInt64.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 64-bit unsigned integer: 0 to 18446744073709551615

let sb = StringBuilder "The range of a 64-bit unsigned integer: "
sb.Append(UInt64.MinValue).Append(" to ").Append UInt64.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 64-bit unsigned integer: 0 to 18446744073709551615

Dim sb As New System.Text.StringBuilder("The range of a 64-bit unsigned integer: ")
sb.Append(UInt64.MinValue).Append(" to ").Append(UInt64.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 64-bit unsigned integer: 0 to 18446744073709551615

El Append(UInt64) método llama al UInt64.ToString(IFormatProvider) método para obtener la representación de cadena de value para la referencia cultural actual. Para controlar el formato de value, llame al AppendFormat método .

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

UInt64

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(ReadOnlySpan<Char>)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de un intervalo de caracteres de solo lectura especificado.

public:
 System::Text::StringBuilder ^ Append(ReadOnlySpan<char> value);

public System.Text.StringBuilder Append (ReadOnlySpan<char> value);

member this.Append : ReadOnlySpan<char> -> System.Text.StringBuilder

Public Function Append (value As ReadOnlySpan(Of Char)) As StringBuilder

Parámetros

value: ReadOnlySpan<Char>

Intervalo de caracteres de solo lectura que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se ha completado la operación de anexado.

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

Append(SByte)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Importante

Esta API no es conforme a CLS.

Anexa a esta instancia la representación en forma de cadena de un entero con signo de 8 bits especificado.

public:
 System::Text::StringBuilder ^ Append(System::SByte value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (sbyte value);

[<System.CLSCompliant(false)>]
member this.Append : sbyte -> System.Text.StringBuilder

Public Function Append (value As SByte) As StringBuilder

Parámetros

value: SByte

Valor que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Atributos: CLSCompliantAttribute

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(SByte) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of an 8-bit signed integer: ");
sb.Append(SByte.MinValue).Append(" to ").Append(SByte.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of an 8-bit unsigned integer: -128 to 127

let sb = StringBuilder "The range of an 8-bit signed integer: "
sb.Append(SByte.MinValue).Append(" to ").Append SByte.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of an 8-bit unsigned integer: -128 to 127

Dim sb As New System.Text.StringBuilder("The range of an 8-bit signed integer: ")
sb.Append(SByte.MinValue).Append(" to ").Append(SByte.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of an 8-bit unsigned integer: -128 to 127

El Append(SByte) método llama al SByte.ToString(IFormatProvider) método para obtener la representación de cadena de value para la referencia cultural actual. Para controlar el formato de value, llame al AppendFormat método .

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

SByte

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(Boolean)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de un valor booleano especificado.

public:
 System::Text::StringBuilder ^ Append(bool value);

public System.Text.StringBuilder Append (bool value);

member this.Append : bool -> System.Text.StringBuilder

Public Function Append (value As Boolean) As StringBuilder

Parámetros

value: Boolean

Valor booleano que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(Boolean) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

bool flag = false;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The value of the flag is ").Append(flag).Append(".");
Console.WriteLine(sb.ToString());
// The example displays the following output:
//       The value of the flag is False.

let flag = false
let sb = StringBuilder()
sb.Append("The value of the flag is ").Append(flag).Append "." |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The value of the flag is False.

Dim flag As Boolean = false
Dim sb As New System.Text.StringBuilder
sb.Append("The value of the flag is ").Append(flag).Append(".")
Console.WriteLine(sb.ToString())
' The example displays the following output:
'       The value of the flag is False.

El Append(Boolean) método llama al Boolean.ToString() método para obtener la representación de cadena de value. La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

Boolean

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(Byte)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de un entero sin signo de 8 bits especificado.

public:
 System::Text::StringBuilder ^ Append(System::Byte value);

public System.Text.StringBuilder Append (byte value);

member this.Append : byte -> System.Text.StringBuilder

Public Function Append (value As Byte) As StringBuilder

Parámetros

value: Byte

Valor que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(Byte) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

Byte[] bytes = { 16, 132, 27, 253 };
System.Text.StringBuilder sb = new System.Text.StringBuilder();
foreach (var value in bytes)
   sb.Append(value).Append(" ");         

Console.WriteLine("The byte array: {0}", sb.ToString());
// The example displays the following output:
//         The byte array: 16 132 27 253

let bytes = [| 16uy; 132uy; 27uy; 253uy |]
let sb = StringBuilder()

for value in bytes do
    sb.Append(value).Append " " |> ignore

printfn $"The byte array: {sb}"
// The example displays the following output:
//         The byte array: 16 132 27 253

Dim bytes() As Byte = { 16, 132, 27, 253 }
Dim sb As New System.Text.StringBuilder()
For Each value In bytes
   sb.Append(value).Append(" ")         
Next
Console.WriteLine("The byte array: {0}", sb.ToString())
' The example displays the following output:
'         The byte array: 16 132 27 253

El Append(Byte) método llama al ToString(IFormatProvider) método para obtener la representación de cadena de value para la referencia cultural actual. Para controlar el formato de value, llame al AppendFormat método .

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

Byte

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(Char)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de un objeto Char especificado.

public:
 System::Text::StringBuilder ^ Append(char value);

public System.Text.StringBuilder Append (char value);

member this.Append : char -> System.Text.StringBuilder

Public Function Append (value As Char) As StringBuilder

Parámetros

value: Char

Unidad de código codificado en UTF-16 que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(Char) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

string str = "Characters in a string.";
System.Text.StringBuilder sb = new System.Text.StringBuilder();
foreach (var ch in str)
   sb.Append(" '").Append(ch).Append("' ");

Console.WriteLine("Characters in the string:");
Console.WriteLine("  {0}", sb);
// The example displays the following output:
//    Characters in the string:
//       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'

let str = "Characters in a string."
let sb = StringBuilder()

for ch in str do
    sb.Append(" '").Append(ch).Append "' " |> ignore

printfn "Characters in the string:"
printfn $"  {sb}"
// The example displays the following output:
//    Characters in the string:
//       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'

Dim str As String = "Characters in a string."
Dim sb As New System.Text.StringBuilder()
For Each ch In str
   sb.Append(" '").Append(ch).Append("' ")
Next
Console.WriteLine("Characters in the string:")
Console.WriteLine("  {0}", sb)
' The example displays the following output:
'    Characters in the string:
'       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

Char

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(Decimal)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de un número decimal especificado.

public:
 System::Text::StringBuilder ^ Append(System::Decimal value);

public System.Text.StringBuilder Append (decimal value);

member this.Append : decimal -> System.Text.StringBuilder

Public Function Append (value As Decimal) As StringBuilder

Parámetros

value: Decimal

Valor que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(Decimal) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1346.19*****

let value = 1346.19m
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1346.19*****

Dim value As Decimal = 1346.19d
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1346.19*****

El Append(Decimal) método llama al Decimal.ToString(IFormatProvider) método para obtener la representación de cadena de value para la referencia cultural actual. Para controlar el formato de value, llame al AppendFormat método .

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

Decimal

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(Double)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de un número de punto flotante de precisión doble especificado.

public:
 System::Text::StringBuilder ^ Append(double value);

public System.Text.StringBuilder Append (double value);

member this.Append : double -> System.Text.StringBuilder

Public Function Append (value As Double) As StringBuilder

Parámetros

value: Double

Valor que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(Double) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

double value = 1034769.47;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1034769.47*****

let value = 1034769.47
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1034769.47*****

Dim value As Double = 1034769.47
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1034769.47*****

El Append(Double) método llama al Double.ToString(IFormatProvider) método para obtener la representación de cadena de value para la referencia cultural actual. Para controlar el formato de value, llame al AppendFormat método .

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

Double

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(Char[])

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de los caracteres Unicode de una matriz especificada.

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value);

public System.Text.StringBuilder Append (char[] value);

public System.Text.StringBuilder Append (char[]? value);

member this.Append : char[] -> System.Text.StringBuilder

Public Function Append (value As Char()) As StringBuilder

Parámetros

value: Char[]

Matriz de caracteres que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

Este método anexa todos los caracteres de la matriz especificada a la instancia actual en el mismo orden que aparecen en value. Si value es null, no se realizan cambios.

El Append(Char[]) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

char[] chars = { 'a', 'e', 'i', 'o', 'u' };
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The characters in the array: ").Append(chars);
Console.WriteLine(sb);
// The example displays the following output:
//      The characters in the array: aeiou

let chars = [| 'a'; 'e'; 'i'; 'o'; 'u' |]
let sb = StringBuilder()
sb.Append("The characters in the array: ").Append chars |> ignore
printfn $"{sb}"
// The example displays the following output:
//      The characters in the array: aeiou

Dim chars() As Char = { "a"c, "e"c, "i"c, "o"c, "u"c }
Dim sb As New System.Text.StringBuilder()
sb.Append("The characters in the array: ").Append(chars)
Console.WriteLine(sb)
' The example displays the following output:
'      The characters in the array: aeiou

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(Int16)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de un entero con signo de 16 bits especificado.

public:
 System::Text::StringBuilder ^ Append(short value);

public System.Text.StringBuilder Append (short value);

member this.Append : int16 -> System.Text.StringBuilder

Public Function Append (value As Short) As StringBuilder

Parámetros

value: Int16

Valor que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(Int16) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

System.Text.StringBuilder sb = new 
       System.Text.StringBuilder("The range of a 16-bit integer: ");
sb.Append(Int16.MinValue).Append(" to ").Append(Int16.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 16-bit integer: -32768 to 32767

let sb = StringBuilder "The range of a 16-bit integer: "
sb.Append(Int16.MinValue).Append(" to ").Append Int16.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 16-bit integer: -32768 to 32767

Dim sb As New System.Text.StringBuilder("The range of a 16-bit integer: ")
sb.Append(Int16.MinValue).Append(" to ").Append(Int16.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 16-bit integer: -32768 to 32767

El Append(Int16) método llama al Int16.ToString(IFormatProvider) método para obtener la representación de cadena de value para la referencia cultural actual. Para controlar el formato de value, llame al AppendFormat método .

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

Int16

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de un entero con signo de 32 bits especificado.

public:
 System::Text::StringBuilder ^ Append(int value);

public System.Text.StringBuilder Append (int value);

member this.Append : int -> System.Text.StringBuilder

Public Function Append (value As Integer) As StringBuilder

Parámetros

value: Int32

Valor que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(Int32) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

System.Text.StringBuilder sb = new 
       System.Text.StringBuilder("The range of a 32-bit integer: ");
sb.Append(Int32.MinValue).Append(" to ").Append(Int32.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 32-bit integer: -2147483648 to 2147483647

let sb = StringBuilder "The range of a 32-bit integer: "
sb.Append(Int32.MinValue).Append(" to ").Append Int32.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 32-bit integer: -2147483648 to 2147483647

Dim sb As New System.Text.StringBuilder("The range of a 32-bit integer: ")
sb.Append(Int32.MinValue).Append(" to ").Append(Int32.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 32-bit integer: -2147483648 to 2147483647

El Append(Int32) método llama al Int32.ToString(IFormatProvider) método para obtener la representación de cadena de value para la referencia cultural actual. Para controlar el formato de value, llame al AppendFormat método .

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

Int32

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(Int64)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de un entero con signo de 64 bits especificado.

public:
 System::Text::StringBuilder ^ Append(long value);

public System.Text.StringBuilder Append (long value);

member this.Append : int64 -> System.Text.StringBuilder

Public Function Append (value As Long) As StringBuilder

Parámetros

value: Int64

Valor que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(Int64) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 64-bit integer: ");
sb.Append(Int64.MinValue).Append(" to ").Append(Int64.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807

let sb = StringBuilder "The range of a 64-bit integer: "
sb.Append(Int64.MinValue).Append(" to ").Append Int64.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807

Dim sb As New System.Text.StringBuilder("The range of a 64-bit integer: ")
sb.Append(Int64.MinValue).Append(" to ").Append(Int64.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807

El Append(Int64) método llama Int64.ToString(IFormatProvider) a para obtener la representación de cadena de value para la referencia cultural actual. Para controlar el formato de value, llame al AppendFormat método .

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

Int64

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(Object)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de un objeto especificado.

public:
 System::Text::StringBuilder ^ Append(System::Object ^ value);

public System.Text.StringBuilder Append (object value);

public System.Text.StringBuilder Append (object? value);

member this.Append : obj -> System.Text.StringBuilder

Public Function Append (value As Object) As StringBuilder

Parámetros

value: Object

Objeto que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se complete la operación de anexado.

Excepciones

ArgumentOutOfRangeException

Si se amplía el valor de esta instancia, se superará MaxCapacity.

Comentarios

El Append(Object) método modifica la instancia existente de esta clase; no devuelve una nueva instancia de clase. Por este motivo, puede llamar a un método o propiedad en la referencia existente y no tiene que asignar el valor devuelto a un StringBuilder objeto, como se muestra en el ejemplo siguiente. Define una clase, crea un DogDog objeto y realiza tres llamadas al Append método para crear una cadena que contenga el nombre y la raza del perro.

using System;

public class Dog
{
   private string dogBreed;
   private string dogName;
   
   public Dog(string name, string breed)
   {
      this.dogName = name;
      this.dogBreed = breed;
   }
   
   public string Breed {
      get { return this.dogBreed; }
   }
   
   public string Name {
      get { return this.dogName; }
   }
   
   public override string ToString()
   {
      return this.dogName;
   }
}

public class Example
{
   public static void Main()
   {
      Dog dog1 = new Dog("Yiska", "Alaskan Malamute");
      System.Text.StringBuilder sb = new System.Text.StringBuilder();     
      sb.Append(dog1).Append(", Breed: ").Append(dog1.Breed);  
      Console.WriteLine(sb);
   }
}
// The example displays the following output:
//        Yiska, Breed: Alaskan Malamute

open System.Text

type Dog(name: string, breed: string) =
    member _.Name = name
    member _.Breed = breed
    override _.ToString() = name

let dog1 = Dog("Yiska", "Alaskan Malamute")
let sb = StringBuilder()
sb.Append(dog1).Append(", Breed: ").Append dog1.Breed |> printfn "%O"

// The example displays the following output:
//        Yiska, Breed: Alaskan Malamute

Public Class Dog
   Private dogBreed As String
   Private dogName As String
   
   Public Sub New(name As String, breed As String)
      Me.dogName = name
      Me.dogBreed = breed
   End Sub
   
   Public ReadOnly Property Breed As String
      Get
         Return Me.dogBreed
      End Get
   End Property
   
   Public ReadOnly Property Name As String
      Get
         Return Me.dogName
      End Get
   End Property
   
   Public Overrides Function ToString() As String
      Return Me.dogName
   End Function
End Class
   
Module Example
   Public Sub Main()
      Dim dog1 As New Dog("Yiska", "Alaskan Malamute")
      Dim sb As New System.Text.StringBuilder()     
      sb.Append(dog1).Append(", Breed: ").Append(dog1.Breed)  
      Console.WriteLine(sb)
   End Sub
End Module
' The example displays the following output:
'       Yiska, Breed: Alaskan Malamute

El Append(Object) método llama al Object.ToString método para obtener la representación de cadena de value. Si value es null, no se realizan cambios en el StringBuilder objeto .

La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

Object

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Append(ReadOnlyMemory<Char>)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Anexa a esta instancia la representación en forma de cadena de una región de memoria de carácter de solo lectura especificado.

public:
 System::Text::StringBuilder ^ Append(ReadOnlyMemory<char> value);

public System.Text.StringBuilder Append (ReadOnlyMemory<char> value);

member this.Append : ReadOnlyMemory<char> -> System.Text.StringBuilder

Public Function Append (value As ReadOnlyMemory(Of Char)) As StringBuilder

Parámetros

value: ReadOnlyMemory<Char>

Región de memoria de carácter de solo lectura que se va a anexar.

Devoluciones

StringBuilder

Referencia a esta instancia después de que se ha completado la operación de anexado.

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9

Compartir a través de

StringBuilder.Append Método

Definición

Sobrecargas

Append(StringBuilder)

Parámetros

Devoluciones

Se aplica a

Append(StringBuilder+AppendInterpolatedStringHandler)

Parámetros

Devoluciones

Se aplica a

Append(UInt16)

Parámetros

Devoluciones

Excepciones

Comentarios

Notas a los autores de las llamadas

Consulte también

Se aplica a

Append(UInt32)

Parámetros

Devoluciones

Excepciones

Comentarios

Notas a los autores de las llamadas

Consulte también

Se aplica a

Append(Char, Int32)

Parámetros

Devoluciones

Excepciones

Comentarios

Notas a los autores de las llamadas

Consulte también

Se aplica a

Append(Char[], Int32, Int32)

Parámetros

Devoluciones

Excepciones

Comentarios

Notas a los autores de las llamadas

Consulte también

Se aplica a

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Parámetros

Devoluciones

Se aplica a

Append(String)

Parámetros

Devoluciones

Excepciones

Comentarios

Notas a los autores de las llamadas

Consulte también

Se aplica a

Append(String, Int32, Int32)

Parámetros

Devoluciones

Excepciones

Comentarios

Notas a los autores de las llamadas

Consulte también

Se aplica a

Append(StringBuilder, Int32, Int32)

Parámetros

Devoluciones

Se aplica a

Append(Char*, Int32)

Parámetros

Devoluciones

Excepciones

Comentarios

Notas a los autores de las llamadas

Se aplica a

Append(Single)

Parámetros

Devoluciones

Excepciones

Comentarios