StringBuilder.Insert Método

Definición

Espacio de nombres:: System.Text

Ensamblados:: mscorlib.dll, System.Runtime.dll

Ensamblados:: netstandard.dll, System.Runtime.dll

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í.

Inserta la representación de cadena de un objeto especificado en esta instancia en una posición de carácter especificada.

Sobrecargas

Nombre	Description
Insert(Int32, String, Int32)	Inserta una o varias copias de una cadena especificada en esta instancia en la posición de carácter especificada.
Insert(Int32, UInt64)	Inserta la representación de cadena de un entero de 64 bits sin signo en esta instancia en la posición de carácter especificada.
Insert(Int32, UInt32)	Inserta la representación de cadena de un entero de 32 bits sin signo en esta instancia en la posición de carácter especificada.
Insert(Int32, UInt16)	Inserta la representación de cadena de un entero de 16 bits sin signo en esta instancia en la posición de carácter especificada.
Insert(Int32, Rune)
Insert(Int32, String)	Inserta una cadena en esta instancia en la posición de carácter especificada.
Insert(Int32, Char[], Int32, Int32)	Inserta la representación de cadena de una subbarray especificada de caracteres Unicode en esta instancia en la posición de carácter especificada.
Insert(Int32, Single)	Inserta la representación de cadena de un número de punto flotante de precisión sencilla en esta instancia en la posición de carácter especificada.
Insert(Int32, SByte)	Inserta la representación de cadena de un entero con signo de 8 bits especificado en esta instancia en la posición de carácter especificada.
Insert(Int32, ReadOnlySpan<Char>)	Inserta la secuencia de caracteres en esta instancia en la posición de carácter especificada.
Insert(Int32, Int16)	Inserta la representación de cadena de un entero con signo de 16 bits especificado en esta instancia en la posición de carácter especificada.
Insert(Int32, Int64)	Inserta la representación de cadena de un entero con signo de 64 bits en esta instancia en la posición de carácter especificada.
Insert(Int32, Int32)	Inserta la representación de cadena de un entero de 32 bits con signo especificado en esta instancia en la posición de carácter especificada.
Insert(Int32, Double)	Inserta la representación de cadena de un número de punto flotante de precisión doble en esta instancia en la posición de carácter especificada.
Insert(Int32, Decimal)	Inserta la representación de cadena de un número decimal en esta instancia en la posición de carácter especificada.
Insert(Int32, Char[])	Inserta la representación de cadena de una matriz especificada de caracteres Unicode en esta instancia en la posición de carácter especificada.
Insert(Int32, Char)	Inserta la representación de cadena de un carácter Unicode especificado en esta instancia en la posición de carácter especificada.
Insert(Int32, Byte)	Inserta la representación de cadena de un entero de 8 bits sin signo especificado en esta instancia en la posición de carácter especificada.
Insert(Int32, Boolean)	Inserta la representación de cadena de un valor booleano en esta instancia en la posición de carácter especificada.
Insert(Int32, Object)	Inserta la representación de cadena de un objeto en esta instancia en la posición de carácter especificada.

Ejemplos

En el ejemplo siguiente se muestra el Insert método .

using System;
using System.Text;

class Sample
{
//                         index: 012345
    static string initialValue = "--[]--";
    static StringBuilder sb;

    public static void Main()
    {
    string      xyz       = "xyz";
    char[]      abc       = {'a', 'b', 'c'};
    char        star      = '*';
    Object 	obj       = 0;

    bool        xBool     = true;
    byte        xByte     = 1;
    short       xInt16    = 2;
    int         xInt32    = 3;
    long        xInt64    = 4;
    Decimal     xDecimal  = 5;
    float       xSingle   = 6.6F;
    double      xDouble   = 7.7;

// The following types are not CLS-compliant.
    ushort      xUInt16   = 8;
    uint        xUInt32   = 9;
    ulong       xUInt64   = 10;
    sbyte       xSByte    = -11;
//
    Console.WriteLine("StringBuilder.Insert method");
    sb = new StringBuilder(initialValue);

    sb.Insert(3, xyz, 2);
    Show(1, sb);

    sb.Insert(3, xyz);
    Show(2, sb);

    sb.Insert(3, star);
    Show(3, sb);

    sb.Insert(3, abc);
    Show(4, sb);

    sb.Insert(3, abc, 1, 2);
    Show(5, sb);

    sb.Insert(3, xBool);     // True
    Show(6, sb);

    sb.Insert(3, obj);       // 0
    Show(7, sb);

    sb.Insert(3, xByte);     // 1
    Show(8, sb);

    sb.Insert(3, xInt16);    // 2
    Show(9, sb);

    sb.Insert(3, xInt32);    // 3
    Show(10, sb);

    sb.Insert(3, xInt64);    // 4
    Show(11, sb);

    sb.Insert(3, xDecimal);  // 5
    Show(12, sb);

    sb.Insert(3, xSingle);   // 6.6
    Show(13, sb);

    sb.Insert(3, xDouble);   // 7.7
    Show(14, sb);

// The following Insert methods are not CLS-compliant.
    sb.Insert(3, xUInt16);   // 8
    Show(15, sb);

    sb.Insert(3, xUInt32);   // 9
    Show(16, sb);

    sb.Insert(3, xUInt64);   // 10
    Show(17, sb);

    sb.Insert(3, xSByte);    // -11
    Show(18, sb);
//
    }

    public static void Show(int overloadNumber, StringBuilder sbs)
    {
    Console.WriteLine("{0,2:G} = {1}", overloadNumber, sbs.ToString());
    sb = new StringBuilder(initialValue);
    }
}
/*
This example produces the following results:

StringBuilder.Insert method
 1 = --[xyzxyz]--
 2 = --[xyz]--
 3 = --[*]--
 4 = --[abc]--
 5 = --[bc]--
 6 = --[True]--
 7 = --[0]--
 8 = --[1]--
 9 = --[2]--
10 = --[3]--
11 = --[4]--
12 = --[5]--
13 = --[6.6]--
14 = --[7.7]--
15 = --[8]--
16 = --[9]--
17 = --[10]--
18 = --[-11]--

*/

open System.Text

let initialValue = "--[]--"

let show overloadNumber (sbs: StringBuilder) =
    printfn $"{overloadNumber, 2:G} = {sbs}"
    sbs.Clear().Append initialValue |> ignore

let xyz = "xyz"
let abc = [| 'a'; 'b'; 'c' |]
let star = '*'
let obj: obj = 0

let xBool = true
let xByte = 1uy
let xInt16 = 2s
let xInt32 = 3
let xInt64 = 4L
let xDecimal = 5M
let xSingle = 6.6f
let xDouble = 7.7

// The following types are not CLS-compliant.
let xUInt16 = 8us
let xUInt32 = 9u
let xUInt64 = 10uL
let xSByte = -11y

printfn "StringBuilder.Insert method"
let sb = StringBuilder initialValue

sb.Insert(3, xyz, 2) |> ignore
show 1 sb

sb.Insert(3, xyz) |> ignore
show 2 sb

sb.Insert(3, star) |> ignore
show 3 sb

sb.Insert(3, abc) |> ignore
show 4 sb

sb.Insert(3, abc, 1, 2) |> ignore
show 5 sb

sb.Insert(3, xBool) |> ignore // True
show 6 sb

sb.Insert(3, obj) |> ignore // 0
show 7 sb

sb.Insert(3, xByte) |> ignore // 1
show 8 sb

sb.Insert(3, xInt16) |> ignore // 2
show 9 sb

sb.Insert(3, xInt32) |> ignore // 3
show 10 sb

sb.Insert(3, xInt64) |> ignore // 4
show 11 sb

sb.Insert(3, xDecimal) |> ignore // 5
show 12 sb

sb.Insert(3, xSingle) |> ignore // 6.6
show 13 sb

sb.Insert(3, xDouble) |> ignore // 7.7
show 14 sb

// The following Insert methods are not CLS-compliant.
sb.Insert(3, xUInt16) |> ignore // 8
show 15 sb

sb.Insert(3, xUInt32) |> ignore // 9
show 16 sb

sb.Insert(3, xUInt64) |> ignore // 10
show 17 sb

sb.Insert(3, xSByte) |> ignore // -11
show 18 sb

// This example produces the following results:
//       StringBuilder.Insert method
//        1 = --[xyzxyz]--
//        2 = --[xyz]--
//        3 = --[*]--
//        4 = --[abc]--
//        5 = --[bc]--
//        6 = --[True]--
//        7 = --[0]--
//        8 = --[1]--
//        9 = --[2]--
//       10 = --[3]--
//       11 = --[4]--
//       12 = --[5]--
//       13 = --[6.6]--
//       14 = --[7.7]--
//       15 = --[8]--
//       16 = --[9]--
//       17 = --[10]--
//       18 = --[-11]--

Imports System.Text

Class Sample
   '                                 index: 012345
   Private Shared initialValue As String = "--[]--"
   Private Shared sb As StringBuilder
   
   Public Shared Sub Main()
      Dim xyz As String = "xyz"
      Dim abc As Char() =  {"a"c, "b"c, "c"c}
      Dim star As Char = "*"c
      Dim obj As [Object] = 0
      
      Dim xBool As Boolean = True
      Dim xByte As Byte = 1
      Dim xInt16 As Short = 2
      Dim xInt32 As Integer = 3
      Dim xInt64 As Long = 4
      Dim xDecimal As [Decimal] = 5
      Dim xSingle As Single = 6.6F
      Dim xDouble As Double = 7.7
      
      ' The following types are not CLS-compliant.
      ' Dim xUInt16 As System.UInt16 = 8 
      ' Dim xUInt32 As System.UInt32 = 9
      ' Dim xUInt64 As System.UInt64 = 10 
      ' Dim xSByte As System.SByte = - 11
      '
      Console.WriteLine("StringBuilder.Insert method")
      sb = New StringBuilder(initialValue)
      
      sb.Insert(3, xyz, 2)
      Show(1, sb)
      
      sb.Insert(3, xyz)
      Show(2, sb)
      
      sb.Insert(3, star)
      Show(3, sb)
      
      sb.Insert(3, abc)
      Show(4, sb)
      
      sb.Insert(3, abc, 1, 2)
      Show(5, sb)
      
      sb.Insert(3, xBool)     ' True
      Show(6, sb)
      
      sb.Insert(3, obj)       ' 0
      Show(7, sb)
      
      sb.Insert(3, xByte)     ' 1
      Show(8, sb)
      
      sb.Insert(3, xInt16)    ' 2
      Show(9, sb)
      
      sb.Insert(3, xInt32)    ' 3
      Show(10, sb)
      
      sb.Insert(3, xInt64)    ' 4
      Show(11, sb)
      
      sb.Insert(3, xDecimal)  ' 5
      Show(12, sb)
      
      sb.Insert(3, xSingle)   ' 6.6
      Show(13, sb)
      
      sb.Insert(3, xDouble)   ' 7.7
      Show(14, sb)
      
      ' The following Insert methods are not CLS-compliant.
      ' sb.Insert(3, xUInt16) ' 8
      ' sb.Insert(3, xUInt32) ' 9
      ' sb.Insert(3, xUInt64) ' 10
      ' sb.Insert(3, xSByte)  ' -11

   End Sub
   
   Public Shared Sub Show(overloadNumber As Integer, sbs As StringBuilder)
      Console.WriteLine("{0,2:G} = {1}", overloadNumber, sbs.ToString())
      sb = New StringBuilder(initialValue)
   End Sub
End Class
'
'This example produces the following results:
'
'StringBuilder.Insert method
' 1 = --[xyzxyz]--
' 2 = --[xyz]--
' 3 = --[*]--
' 4 = --[abc]--
' 5 = --[bc]--
' 6 = --[True]--
' 7 = --[0]--
' 8 = --[1]--
' 9 = --[2]--
'10 = --[3]--
'11 = --[4]--
'12 = --[5]--
'13 = --[6.6]--
'14 = --[7.7]--
'

Insert(Int32, String, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta una o varias copias de una cadena especificada en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, System::String ^ value, int count);

public System.Text.StringBuilder Insert(int index, string value, int count);

public System.Text.StringBuilder Insert(int index, string? value, int count);

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

Public Function Insert (index As Integer, value As String, count As Integer) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: String

La cadena que se insertará.

count: Int32

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

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la inserción.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud actual de esta instancia.

O bien:

count es menor que cero.

OutOfMemoryException

La longitud actual de este StringBuilder objeto más la longitud de value los tiempos count supera MaxCapacity.

Comentarios

Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. La capacidad de esta instancia se ajusta según sea necesario.

Este StringBuilder objeto no se cambia si value es null, no null es , value pero su longitud es cero o count es cero.

Consulte también

String

Se aplica a

Insert(Int32, UInt64)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Importante

Esta API no es conforme a CLS.

Inserta la representación de cadena de un entero de 64 bits sin signo en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, System::UInt64 value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert(int index, ulong value);

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

Public Function Insert (index As Integer, value As ULong) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: UInt64

Valor que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Atributos: CLSCompliantAttribute

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

OutOfMemoryException

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

UInt64.ToString se usa para obtener una representación de cadena de value. Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

En .NET Framework 3.5 Service Pack 1 y versiones anteriores, las llamadas a este método generaron una ArgumentOutOfRangeException excepción si la inserción value haría que la longitud total del objeto superara MaxCapacity. A partir de .NET Framework 4, el método produce una OutOfMemoryExceptionexcepción .

Consulte también

UInt64

Se aplica a

Insert(Int32, UInt32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Importante

Esta API no es conforme a CLS.

Inserta la representación de cadena de un entero de 32 bits sin signo en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, System::UInt32 value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert(int index, uint value);

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

Public Function Insert (index As Integer, value As UInteger) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: UInt32

Valor que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Atributos: CLSCompliantAttribute

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

OutOfMemoryException

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

UInt32.ToString se usa para obtener una representación de cadena de value. Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. 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

Insert(Int32, UInt16)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Importante

Esta API no es conforme a CLS.

Inserta la representación de cadena de un entero de 16 bits sin signo en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, System::UInt16 value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert(int index, ushort value);

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

Public Function Insert (index As Integer, value As UShort) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: UInt16

Valor que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Atributos: CLSCompliantAttribute

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

OutOfMemoryException

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

UInt16.ToString se usa para obtener una representación de cadena de value. Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. La capacidad de esta instancia se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

UInt16

Se aplica a

Insert(Int32, Rune)

public:
 System::Text::StringBuilder ^ Insert(int index, System::Text::Rune value);

public System.Text.StringBuilder Insert(int index, System.Text.Rune value);

member this.Insert : int * System.Text.Rune -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Rune) As StringBuilder

Parámetros

index: Int32

value: Rune

Devoluciones

StringBuilder

Se aplica a

Insert(Int32, String)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta una cadena en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, System::String ^ value);

public System.Text.StringBuilder Insert(int index, string value);

public System.Text.StringBuilder Insert(int index, string? value);

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

Public Function Insert (index As Integer, value As String) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: String

La cadena que se insertará.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud actual de esta instancia.

O bien:

La longitud actual de este StringBuilder objeto más la longitud de value supera MaxCapacity.

Comentarios

Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. La capacidad se ajusta según sea necesario.

Esta instancia de StringBuilder no se cambia si value es null, o value no null , pero su longitud es cero.

Consulte también

String

Se aplica a

Insert(Int32, Char[], Int32, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta la representación de cadena de una subbarray especificada de caracteres Unicode en esta instancia en la posición de carácter especificada.

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

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

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

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

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

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: Char[]

Matriz de caracteres.

startIndex: Int32

Índice inicial dentro de value.

charCount: Int32

Número de caracteres que se van a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Excepciones

ArgumentNullException

value es nully y startIndexcharCount no son cero.

ArgumentOutOfRangeException

index, startIndexo charCount es menor que cero.

O bien:

index es mayor que la longitud de esta instancia.

O bien:

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

O bien:

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. La capacidad de esta instancia se ajusta según sea necesario.

Se aplica a

Insert(Int32, Single)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta la representación de cadena de un número de punto flotante de precisión sencilla en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, float value);

public System.Text.StringBuilder Insert(int index, float value);

member this.Insert : int * single -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Single) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: Single

Valor que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

OutOfMemoryException

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

Single.ToString se usa para obtener una representación de cadena de value. Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. 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

Insert(Int32, SByte)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Importante

Esta API no es conforme a CLS.

Inserta la representación de cadena de un entero con signo de 8 bits especificado en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, System::SByte value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert(int index, sbyte value);

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

Public Function Insert (index As Integer, value As SByte) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: SByte

Valor que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Atributos: CLSCompliantAttribute

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

OutOfMemoryException

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

SByte.ToString se usa para obtener una representación de cadena de value. Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. La capacidad se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

SByte

Se aplica a

Insert(Int32, ReadOnlySpan<Char>)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta la secuencia de caracteres en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, ReadOnlySpan<char> value);

public System.Text.StringBuilder Insert(int index, ReadOnlySpan<char> value);

member this.Insert : int * ReadOnlySpan<char> -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As ReadOnlySpan(Of Char)) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: ReadOnlySpan<Char>

Intervalo de caracteres que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Comentarios

Los caracteres existentes se desplazan para dejar espacio para la secuencia de caracteres en para value insertarlo. La capacidad se ajusta según sea necesario.

Se aplica a

Insert(Int32, Int16)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta la representación de cadena de un entero con signo de 16 bits especificado en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, short value);

public System.Text.StringBuilder Insert(int index, short value);

member this.Insert : int * int16 -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Short) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: Int16

Valor que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

OutOfMemoryException

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

Int16.ToString se usa para obtener una representación de cadena de value. Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. 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

Insert(Int32, Int64)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta la representación de cadena de un entero con signo de 64 bits en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, long value);

public System.Text.StringBuilder Insert(int index, long value);

member this.Insert : int * int64 -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Long) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: Int64

Valor que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

OutOfMemoryException

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

Int64.ToString se usa para obtener una representación de cadena de value. Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. 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

Insert(Int32, Int32)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta la representación de cadena de un entero de 32 bits con signo especificado en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, int value);

public System.Text.StringBuilder Insert(int index, int value);

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

Public Function Insert (index As Integer, value As Integer) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: Int32

Valor que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

OutOfMemoryException

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

Int32.ToString se usa para obtener una representación de cadena de value. Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. 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

Insert(Int32, Double)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta la representación de cadena de un número de punto flotante de precisión doble en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, double value);

public System.Text.StringBuilder Insert(int index, double value);

member this.Insert : int * double -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Double) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: Double

Valor que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

OutOfMemoryException

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

Double.ToString se usa para obtener una representación de cadena de value. Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. 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

Insert(Int32, Decimal)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta la representación de cadena de un número decimal en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, System::Decimal value);

public System.Text.StringBuilder Insert(int index, decimal value);

member this.Insert : int * decimal -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Decimal) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: Decimal

Valor que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

OutOfMemoryException

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

Decimal.ToString se usa para obtener una representación de cadena de value. Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. 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

Insert(Int32, Char[])

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta la representación de cadena de una matriz especificada de caracteres Unicode en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, cli::array <char> ^ value);

public System.Text.StringBuilder Insert(int index, char[] value);

public System.Text.StringBuilder Insert(int index, char[]? value);

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

Public Function Insert (index As Integer, value As Char()) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: Char[]

Matriz de caracteres que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

O bien:

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. La capacidad de esta instancia se ajusta según sea necesario.

Si value es null, StringBuilder no se cambia .

Se aplica a

Insert(Int32, Char)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta la representación de cadena de un carácter Unicode especificado en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, char value);

public System.Text.StringBuilder Insert(int index, char value);

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

Public Function Insert (index As Integer, value As Char) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: Char

Valor que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

O bien:

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

Char.ToString se usa para obtener una representación de cadena de value. Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. La capacidad de esta instancia se ajusta según sea necesario.

Consulte también

Char

Se aplica a

Insert(Int32, Byte)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta la representación de cadena de un entero de 8 bits sin signo especificado en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, System::Byte value);

public System.Text.StringBuilder Insert(int index, byte value);

member this.Insert : int * byte -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Byte) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: Byte

Valor que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

OutOfMemoryException

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

Byte.ToString se usa para obtener una representación de cadena de value. Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. 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

Insert(Int32, Boolean)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta la representación de cadena de un valor booleano en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, bool value);

public System.Text.StringBuilder Insert(int index, bool value);

member this.Insert : int * bool -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Boolean) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: Boolean

Valor que se va a insertar.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

OutOfMemoryException

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

Boolean.ToString se usa para obtener una representación de cadena de value. Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. La capacidad se ajusta según sea necesario.

Notas a los autores de las llamadas

Consulte también

Boolean

Se aplica a

Insert(Int32, Object)

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Source:: StringBuilder.cs

Inserta la representación de cadena de un objeto en esta instancia en la posición de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, System::Object ^ value);

public System.Text.StringBuilder Insert(int index, object value);

public System.Text.StringBuilder Insert(int index, object? value);

member this.Insert : int * obj -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Object) As StringBuilder

Parámetros

index: Int32

Posición en esta instancia donde comienza la inserción.

value: Object

Objeto que se va a insertar o null.

Devoluciones

StringBuilder

Referencia a esta instancia una vez completada la operación de inserción.

Excepciones

ArgumentOutOfRangeException

index es menor que cero o mayor que la longitud de esta instancia.

OutOfMemoryException

Al ampliar el valor de esta instancia, se superaría MaxCapacity.

Comentarios

Object.ToString se usa para obtener una representación de cadena de value. Los caracteres existentes se desplazan para dejar espacio para el nuevo texto. La capacidad de esta instancia se ajusta según sea necesario.

Si value es null, el valor de esta instancia no cambia.

Notas a los autores de las llamadas

Consulte también

Object

Se aplica a

Retroalimentació

Ha estat útil aquesta pàgina?

Comparteix via

StringBuilder.Insert Método

Definición

Sobrecargas

Ejemplos

Insert(Int32, String, Int32)

Parámetros

Devoluciones

Excepciones

Comentarios

Consulte también

Se aplica a

Insert(Int32, UInt64)

Parámetros

Devoluciones

Excepciones

Comentarios

Notas a los autores de las llamadas

Consulte también

Se aplica a

Insert(Int32, UInt32)

Parámetros

Devoluciones

Excepciones

Comentarios

Notas a los autores de las llamadas

Consulte también

Se aplica a

Insert(Int32, UInt16)

Parámetros

Devoluciones

Excepciones

Comentarios

Notas a los autores de las llamadas

Consulte también

Se aplica a

Insert(Int32, Rune)

Parámetros

Devoluciones

Se aplica a

Insert(Int32, String)

Parámetros

Devoluciones

Excepciones

Comentarios

Consulte también

Se aplica a

Insert(Int32, Char[], Int32, Int32)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

Insert(Int32, Single)

Parámetros

Devoluciones

Excepciones

Comentarios

Notas a los autores de las llamadas

Consulte también

Se aplica a

Insert(Int32, SByte)

Parámetros

Devoluciones

Excepciones

Comentarios

Notas a los autores de las llamadas

Consulte también

Se aplica a

Insert(Int32, ReadOnlySpan<Char>)

Parámetros

Devoluciones

Comentarios

Se aplica a

Insert(Int32, Int16)

Parámetros

Devoluciones

Excepciones

Comentarios

Notas a los autores de las llamadas