Compartir a través de


StringBuilder.Insert Método

Definición

Inserta en la instancia la representación en forma de cadena de un objeto concreto en la posición del carácter que se haya especificado.

Sobrecargas

Insert(Int32, SByte)

Inserta en la instancia la representación en forma de cadena de un entero de 8 bits con signo especificado, en la posición del carácter que se haya indicado.

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

Inserta en la instancia la representación en forma de cadena de una submatriz concreta de caracteres Unicode en la posición del carácter que se haya especificado.

Insert(Int32, String, Int32)

Inserta en la instancia una o más copias de una cadena concreta en la posición del carácter que se haya especificado.

Insert(Int32, UInt64)

Inserta en la instancia la representación en forma de cadena de un entero de 64 bits sin signo, en la posición del carácter que se haya especificado.

Insert(Int32, UInt32)

Inserta en la instancia la representación en forma de cadena de un entero de 32 bits sin signo, en la posición del carácter que se haya especificado.

Insert(Int32, UInt16)

Inserta en la instancia la representación en forma de cadena de un entero de 16 bits sin signo, en la posición del carácter que se haya especificado.

Insert(Int32, String)

Inserta una cadena en la instancia en la posición del carácter que se haya especificado.

Insert(Int32, Single)

Inserta en la instancia la representación en forma de cadena de un número de punto flotante de precisión sencilla, en la posición del carácter que se haya especificado.

Insert(Int32, ReadOnlySpan<Char>)

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

Insert(Int32, Int16)

Inserta en la instancia la representación en forma de cadena de un entero de 16 bits con signo especificado, en la posición del carácter que se haya indicado.

Insert(Int32, Int64)

Inserta en la instancia la representación en forma de cadena de un entero de 64 bits con signo, en la posición del carácter que se haya especificado.

Insert(Int32, Int32)

Inserta en la instancia la representación en forma de cadena de un entero de 32 bits con signo especificado, en la posición del carácter que se haya indicado.

Insert(Int32, Object)

Inserta en la instancia la representación en forma de cadena de un objeto en la posición del carácter que se haya especificado.

Insert(Int32, Double)

Inserta en la instancia la representación en forma de cadena de un número de punto flotante de doble precisión en la posición del carácter que se haya especificado.

Insert(Int32, Decimal)

Inserta en la instancia la representación en forma de cadena de un número decimal en la posición del carácter que se haya especificado.

Insert(Int32, Char[])

Inserta en la instancia la representación en forma de cadena de una matriz concreta de caracteres Unicode en la posición del carácter que se haya especificado.

Insert(Int32, Char)

Inserta en la instancia la representación en forma de cadena de un carácter Unicode concreto en la posición del carácter que se haya especificado.

Insert(Int32, Byte)

Inserta en la instancia la representación en forma de cadena de un entero de 8 bits sin signo, en la posición del carácter que se haya especificado.

Insert(Int32, Boolean)

Inserta en la instancia la representación en forma de cadena de un valor booleano en la posición del carácter que se haya especificado.

Ejemplos

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

using namespace System;
using namespace System::Text;
ref class Sample
{
private:

   //                           index: 012345
   static String^ initialValue = "--[]--";
   static StringBuilder^ sb;

public:
   static void Main()
   {
      String^ xyz = "xyz";
      array<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.
      UInt16 xUInt16 = 8;
      UInt32 xUInt32 = 9;
      UInt64 xUInt64 = 10;
      SByte xSByte = -11;
      
      //
      Console::WriteLine( "StringBuilder.Insert method" );
      sb = gcnew 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 );
      
      //
   }

   static void Show( int overloadNumber, StringBuilder^ sbs )
   {
      Console::WriteLine( "{0,2:G} = {1}", overloadNumber, sbs );
      sb = gcnew StringBuilder( initialValue );
   }

};

int main()
{
   Sample::Main();
}

/*
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]--

*/
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, SByte)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Importante

Esta API no es conforme a CLS.

Inserta en la instancia la representación en forma de cadena de un entero de 8 bits con signo especificado, en la posición del carácter que se haya indicado.

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 la que comienza la inserción en la instancia.

value
SByte

Valor que se va a insertar.

Devoluciones

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

Atributos

Excepciones

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

Si se amplía el valor de esta instancia, se superará 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

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 provocaría que la longitud total del objeto supere MaxCapacity. A partir de .NET Framework 4, el método produce una OutOfMemoryExceptionexcepción .

Consulte también

Se aplica a

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

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Inserta en la instancia la representación en forma de cadena de una submatriz concreta de caracteres Unicode en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
Char[]

Matriz de caracteres.

startIndex
Int32

Índice inicial de value.

charCount
Int32

Número de caracteres que se van a insertar.

Devoluciones

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

Excepciones

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

index, startIndex o charCount es menor que cero.

O bien

index es mayor que la longitud de esta instancia.

o bien

startIndex más charCount no es una posición dentro de value.

o bien

Si se amplía el valor de esta instancia, se superará 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, String, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Inserta en la instancia una o más copias de una cadena concreta en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
String

Cadena que se va a insertar.

count
Int32

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

Devoluciones

Referencia a la instancia después de que se complete la inserción.

Excepciones

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

o bien

count es menor que cero.

La longitud actual de este objeto StringBuilder más la longitud de value veces 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, value no null es pero su longitud es cero o count es cero.

Consulte también

Se aplica a

Insert(Int32, UInt64)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Importante

Esta API no es conforme a CLS.

Inserta en la instancia la representación en forma de cadena de un entero de 64 bits sin signo, en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
UInt64

Valor que se va a insertar.

Devoluciones

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

Atributos

Excepciones

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

Si se amplía el valor de esta instancia, se superará 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 provocaría que la longitud total del objeto supere MaxCapacity. A partir de .NET Framework 4, el método produce una OutOfMemoryExceptionexcepción .

Consulte también

Se aplica a

Insert(Int32, UInt32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Importante

Esta API no es conforme a CLS.

Inserta en la instancia la representación en forma de cadena de un entero de 32 bits sin signo, en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
UInt32

Valor que se va a insertar.

Devoluciones

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

Atributos

Excepciones

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

Si se amplía el valor de esta instancia, se superará 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

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 provocaría que la longitud total del objeto supere MaxCapacity. A partir de .NET Framework 4, el método produce una OutOfMemoryExceptionexcepción .

Consulte también

Se aplica a

Insert(Int32, UInt16)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Importante

Esta API no es conforme a CLS.

Inserta en la instancia la representación en forma de cadena de un entero de 16 bits sin signo, en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
UInt16

Valor que se va a insertar.

Devoluciones

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

Atributos

Excepciones

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

Si se amplía el valor de esta instancia, se superará 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

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 provocaría que la longitud total del objeto supere MaxCapacity. A partir de .NET Framework 4, el método produce una OutOfMemoryExceptionexcepción .

Consulte también

Se aplica a

Insert(Int32, String)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Inserta una cadena en la instancia en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
String

Cadena que se va a insertar.

Devoluciones

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

Excepciones

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

o bien

La longitud actual de este objeto StringBuilder 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 nullo value no null es , pero su longitud es cero.

Consulte también

Se aplica a

Insert(Int32, Single)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Inserta en la instancia la representación en forma de cadena de un número de punto flotante de precisión sencilla, en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
Single

Valor que se va a insertar.

Devoluciones

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

Excepciones

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

Si se amplía el valor de esta instancia, se superará 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

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 provocaría que la longitud total del objeto supere MaxCapacity. A partir de .NET Framework 4, el método produce una OutOfMemoryExceptionexcepción .

Consulte también

Se aplica a

Insert(Int32, ReadOnlySpan<Char>)

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 la que comienza la inserción en la instancia.

value
ReadOnlySpan<Char>

Intervalo de caracteres que se va a insertar.

Devoluciones

Referencia a la instancia después de que se complete 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

Inserta en la instancia la representación en forma de cadena de un entero de 16 bits con signo especificado, en la posición del carácter que se haya indicado.

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 la que comienza la inserción en la instancia.

value
Int16

Valor que se va a insertar.

Devoluciones

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

Excepciones

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

Si se amplía el valor de esta instancia, se superará 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

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 provocaría que la longitud total del objeto supere MaxCapacity. A partir de .NET Framework 4, el método produce una OutOfMemoryExceptionexcepción .

Consulte también

Se aplica a

Insert(Int32, Int64)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Inserta en la instancia la representación en forma de cadena de un entero de 64 bits con signo, en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
Int64

Valor que se va a insertar.

Devoluciones

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

Excepciones

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

Si se amplía el valor de esta instancia, se superará 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

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 provocaría que la longitud total del objeto supere MaxCapacity. A partir de .NET Framework 4, el método produce una OutOfMemoryExceptionexcepción .

Consulte también

Se aplica a

Insert(Int32, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Inserta en la instancia la representación en forma de cadena de un entero de 32 bits con signo especificado, en la posición del carácter que se haya indicado.

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 la que comienza la inserción en la instancia.

value
Int32

Valor que se va a insertar.

Devoluciones

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

Excepciones

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

Si se amplía el valor de esta instancia, se superará 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

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 provocaría que la longitud total del objeto supere MaxCapacity. A partir de .NET Framework 4, el método produce una OutOfMemoryExceptionexcepción .

Consulte también

Se aplica a

Insert(Int32, Object)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Inserta en la instancia la representación en forma de cadena de un objeto en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
Object

Objeto que se va a insertar o null.

Devoluciones

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

Excepciones

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

Si se amplía el valor de esta instancia, se superará 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

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 provocaría que la longitud total del objeto supere MaxCapacity. A partir de .NET Framework 4, el método produce una OutOfMemoryExceptionexcepción .

Consulte también

Se aplica a

Insert(Int32, Double)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Inserta en la instancia la representación en forma de cadena de un número de punto flotante de doble precisión en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
Double

Valor que se va a insertar.

Devoluciones

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

Excepciones

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

Si se amplía el valor de esta instancia, se superará 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

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 provocaría que la longitud total del objeto supere MaxCapacity. A partir de .NET Framework 4, el método produce una OutOfMemoryExceptionexcepción .

Consulte también

Se aplica a

Insert(Int32, Decimal)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Inserta en la instancia la representación en forma de cadena de un número decimal en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
Decimal

Valor que se va a insertar.

Devoluciones

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

Excepciones

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

Si se amplía el valor de esta instancia, se superará 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

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 provocaría que la longitud total del objeto supere MaxCapacity. A partir de .NET Framework 4, el método produce una OutOfMemoryExceptionexcepción .

Consulte también

Se aplica a

Insert(Int32, Char[])

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Inserta en la instancia la representación en forma de cadena de una matriz concreta de caracteres Unicode en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
Char[]

Matriz de caracteres que se va a insertar.

Devoluciones

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

Excepciones

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

o bien

Si se amplía el valor de esta instancia, se superará 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

Inserta en la instancia la representación en forma de cadena de un carácter Unicode concreto en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
Char

Valor que se va a insertar.

Devoluciones

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

Excepciones

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

o bien

Si se amplía el valor de esta instancia, se superará 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

Se aplica a

Insert(Int32, Byte)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Inserta en la instancia la representación en forma de cadena de un entero de 8 bits sin signo, en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
Byte

Valor que se va a insertar.

Devoluciones

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

Excepciones

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

Si se amplía el valor de esta instancia, se superará 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

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 provocaría que la longitud total del objeto supere MaxCapacity. A partir de .NET Framework 4, el método produce una OutOfMemoryExceptionexcepción .

Consulte también

Se aplica a

Insert(Int32, Boolean)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Inserta en la instancia la representación en forma de cadena de un valor booleano en la posición del carácter que se haya especificado.

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 la que comienza la inserción en la instancia.

value
Boolean

Valor que se va a insertar.

Devoluciones

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

Excepciones

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

Si se amplía el valor de esta instancia, se superará 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

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 provocaría que la longitud total del objeto supere MaxCapacity. A partir de .NET Framework 4, el método produce una OutOfMemoryExceptionexcepción .

Consulte también

Se aplica a