StringBuilder.Insert Método

Referência

Definição

Namespace:: System.Text

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Insere a representação de cadeia de caracteres de um objeto especificado nessa instância na posição do caractere especificada.

Sobrecargas

Insert(Int32, SByte)	Insere a representação de cadeia de caracteres de um inteiro com sinal de 8 bits especificado nessa instância na posição do caractere especificada.
Insert(Int32, Char[], Int32, Int32)	Insere a representação de cadeia de caracteres de uma submatriz de caracteres Unicode especificada nessa instância na posição do caractere especificada.
Insert(Int32, String, Int32)	Insere uma ou mais cópias de uma cadeia de caracteres especificada nesta instância na posição do caractere especificada.
Insert(Int32, UInt64)	Insere a representação de cadeia de caracteres de um inteiro sem sinal de 64 bits nessa instância na posição do caractere especificada.
Insert(Int32, UInt32)	Insere a representação de cadeia de caracteres de um inteiro sem sinal de 32 bits nessa instância na posição do caractere especificada.
Insert(Int32, UInt16)	Insere a representação de cadeia de caracteres de um inteiro sem sinal de 16 bits nessa instância na posição do caractere especificada.
Insert(Int32, String)	Insere uma cadeia de caracteres nesta instância na posição do caractere especificado.
Insert(Int32, Single)	Insere a representação de cadeia de caracteres de um número de ponto flutuante de precisão simples nessa instância na posição do caractere especificada.
Insert(Int32, ReadOnlySpan<Char>)	Insere uma sequência de caracteres nesta instância na posição de caractere especificada.
Insert(Int32, Int16)	Insere a representação de cadeia de caracteres de um inteiro com sinal de 16 bits especificado nessa instância na posição do caractere especificada.
Insert(Int32, Int64)	Insere a representação de cadeia de caracteres de um inteiro com sinal de 64 bits nessa instância na posição do caractere especificada.
Insert(Int32, Int32)	Insere a representação de cadeia de caracteres de um inteiro com sinal de 32 bits especificado nessa instância na posição do caractere especificada.
Insert(Int32, Object)	Insere a representação de cadeia de caracteres de um objeto nessa instância na posição do caractere especificada.
Insert(Int32, Double)	Insere a representação de cadeia de caracteres de um número de ponto flutuante de precisão dupla nessa instância na posição do caractere especificada.
Insert(Int32, Decimal)	Insere a representação de cadeia de caracteres de um número decimal nessa instância na posição do caractere especificada.
Insert(Int32, Char[])	Insere a representação de cadeia de caracteres de uma matriz de caracteres Unicode especificada nessa instância na posição do caractere especificada.
Insert(Int32, Char)	Insere a representação de cadeia de caracteres de um caractere Unicode especificado nessa instância na posição do caractere especificada.
Insert(Int32, Byte)	Insere a representação de cadeia de caracteres de um inteiro sem sinal de 8 bits especificado nessa instância na posição do caractere especificada.
Insert(Int32, Boolean)	Insere a representação de cadeia de caracteres de um valor booliano nessa instância na posição do caractere especificada.

Exemplos

O exemplo a seguir demonstra o 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)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Importante

Esta API não está em conformidade com CLS.

Insere a representação de cadeia de caracteres de um inteiro com sinal de 8 bits especificado nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: SByte

O valor a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Atributos: CLSCompliantAttribute

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

OutOfMemoryException

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

SByte.ToString é usado para obter uma representação de cadeia de caracteres de value. Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade é ajustada conforme necessário.

Notas aos Chamadores

No .NET Framework 3.5 Service Pack 1 e versões anteriores, as chamadas para esse método geraram um ArgumentOutOfRangeException se a inserção value faria com que o comprimento total do objeto excedesse MaxCapacity. Começando com o .NET Framework 4, o método lança um OutOfMemoryException.

Confira também

SByte

Aplica-se a

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

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere a representação de cadeia de caracteres de uma submatriz de caracteres Unicode especificada nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: Char[]

Uma matriz de caracteres.

startIndex: Int32

O índice inicial em value.

charCount: Int32

O número de caracteres a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Exceções

ArgumentNullException

value é null e startIndex e charCount não são zero.

ArgumentOutOfRangeException

index, startIndex ou charCount é menor que zero.

- ou -

index é maior que o tamanho desta instância.

- ou -

startIndex além de charCount não é uma posição no value.

- ou -

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Aplica-se a

Insert(Int32, String, Int32)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere uma ou mais cópias de uma cadeia de caracteres especificada nesta instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: String

A cadeia de caracteres a ser inserida.

count: Int32

O número de vezes para inserir value.

Retornos

StringBuilder

Uma referência a essa instância após a conclusão da inserção.

Exceções

ArgumentOutOfRangeException

index é menor que zero ou maior que o tamanho atual dessa instância.

- ou -

count é menor que zero.

OutOfMemoryException

O tamanho atual deste objeto StringBuilder mais o tamanho de value vezes count excede MaxCapacity.

Comentários

Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Esse StringBuilder objeto não será alterado se value for null, value não null é, mas seu comprimento é zero ou count é zero.

Confira também

String

Aplica-se a

Insert(Int32, UInt64)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Importante

Esta API não está em conformidade com CLS.

Insere a representação de cadeia de caracteres de um inteiro sem sinal de 64 bits nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: UInt64

O valor a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Atributos: CLSCompliantAttribute

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

OutOfMemoryException

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

UInt64.ToString é usado para obter uma representação de cadeia de caracteres de value. Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

Confira também

UInt64

Aplica-se a

Insert(Int32, UInt32)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Importante

Esta API não está em conformidade com CLS.

Insere a representação de cadeia de caracteres de um inteiro sem sinal de 32 bits nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: UInt32

O valor a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Atributos: CLSCompliantAttribute

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

OutOfMemoryException

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

UInt32.ToString é usado para obter uma representação de cadeia de caracteres de value. Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

Confira também

UInt32

Aplica-se a

Insert(Int32, UInt16)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Importante

Esta API não está em conformidade com CLS.

Insere a representação de cadeia de caracteres de um inteiro sem sinal de 16 bits nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: UInt16

O valor a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Atributos: CLSCompliantAttribute

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

OutOfMemoryException

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

UInt16.ToString é usado para obter uma representação de cadeia de caracteres de value. Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

Confira também

UInt16

Aplica-se a

Insert(Int32, String)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere uma cadeia de caracteres nesta instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: String

A cadeia de caracteres a ser inserida.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Exceções

ArgumentOutOfRangeException

index é menor que zero ou maior que o tamanho atual dessa instância.

- ou -

O tamanho atual deste objeto StringBuilder mais o tamanho de value ultrapassa MaxCapacity.

Comentários

Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade é ajustada conforme necessário.

Essa instância de StringBuilder não será alterada se value for nullou value não null , mas seu comprimento for zero.

Confira também

String

Aplica-se a

Insert(Int32, Single)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere a representação de cadeia de caracteres de um número de ponto flutuante de precisão simples nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: Single

O valor a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

OutOfMemoryException

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Single.ToString é usado para obter uma representação de cadeia de caracteres de value. Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

Confira também

Single

Aplica-se a

Insert(Int32, ReadOnlySpan<Char>)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere uma sequência de caracteres nesta instância na posição de caractere 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

A posição nessa instância em que a inserção é iniciada.

value: ReadOnlySpan<Char>

O intervalo de caracteres a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Comentários

Os caracteres existentes são deslocados para abrir espaço para a sequência de caracteres no value para inseri-la. A capacidade é ajustada conforme necessário.

Aplica-se a

Insert(Int32, Int16)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere a representação de cadeia de caracteres de um inteiro com sinal de 16 bits especificado nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: Int16

O valor a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

OutOfMemoryException

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Int16.ToString é usado para obter uma representação de cadeia de caracteres de value. Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

Confira também

Int16

Aplica-se a

Insert(Int32, Int64)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere a representação de cadeia de caracteres de um inteiro com sinal de 64 bits nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: Int64

O valor a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

OutOfMemoryException

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Int64.ToString é usado para obter uma representação de cadeia de caracteres de value. Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

Confira também

Int64

Aplica-se a

Insert(Int32, Int32)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere a representação de cadeia de caracteres de um inteiro com sinal de 32 bits especificado nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: Int32

O valor a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

OutOfMemoryException

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Int32.ToString é usado para obter uma representação de cadeia de caracteres de value. Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

Confira também

Int32

Aplica-se a

Insert(Int32, Object)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere a representação de cadeia de caracteres de um objeto nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: Object

O objeto a ser inserido ou null.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

OutOfMemoryException

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Object.ToString é usado para obter uma representação de cadeia de caracteres de value. Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Se value for null, o valor dessa instância permanecerá inalterado.

Notas aos Chamadores

Confira também

Object

Aplica-se a

Insert(Int32, Double)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere a representação de cadeia de caracteres de um número de ponto flutuante de precisão dupla nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: Double

O valor a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

OutOfMemoryException

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Double.ToString é usado para obter uma representação de cadeia de caracteres de value. Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

Confira também

Double

Aplica-se a

Insert(Int32, Decimal)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere a representação de cadeia de caracteres de um número decimal nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: Decimal

O valor a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

OutOfMemoryException

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Decimal.ToString é usado para obter uma representação de cadeia de caracteres de value. Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

Confira também

Decimal

Aplica-se a

Insert(Int32, Char[])

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere a representação de cadeia de caracteres de uma matriz de caracteres Unicode especificada nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: Char[]

A matriz de caracteres a ser inserida.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

- ou -

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Se value for null, o StringBuilder não será alterado.

Aplica-se a

Insert(Int32, Char)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere a representação de cadeia de caracteres de um caractere Unicode especificado nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: Char

O valor a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

- ou -

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Char.ToString é usado para obter uma representação de cadeia de caracteres de value. Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Confira também

Char

Aplica-se a

Insert(Int32, Byte)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere a representação de cadeia de caracteres de um inteiro sem sinal de 8 bits especificado nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: Byte

O valor a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

OutOfMemoryException

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Byte.ToString é usado para obter uma representação de cadeia de caracteres de value. Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade dessa instância é ajustada conforme necessário.

Notas aos Chamadores

No .NET Framework 3.5 Service Pack 1 e versões anteriores, as chamadas para esse método geravam um ArgumentOutOfRangeException se a inserção value faria com que o comprimento total do objeto excedesse MaxCapacity. Começando com o .NET Framework 4, o método lança um OutOfMemoryException.

Confira também

Byte

Aplica-se a

Insert(Int32, Boolean)

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Origem:: StringBuilder.cs

Insere a representação de cadeia de caracteres de um valor booliano nessa instância na posição do caractere 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

A posição nessa instância em que a inserção é iniciada.

value: Boolean

O valor a ser inserido.

Retornos

StringBuilder

Uma referência a essa instância depois que a operação de inserção é concluída.

Exceções

ArgumentOutOfRangeException

index for menor que zero ou maior que o comprimento dessa instância.

OutOfMemoryException

Aumentar o valor dessa instância excederia MaxCapacity.

Comentários

Boolean.ToString é usado para obter uma representação de cadeia de caracteres de value. Os caracteres existentes são deslocados para abrir espaço para o novo texto. A capacidade é ajustada conforme necessário.

Notas aos Chamadores

Confira também

Boolean

Aplica-se a

Partilhar via

StringBuilder.Insert Método

Definição

Sobrecargas

Exemplos

Insert(Int32, SByte)

Parâmetros

Retornos

Exceções

Comentários

Notas aos Chamadores

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Insert(Int32, String, Int32)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Insert(Int32, UInt64)

Parâmetros

Retornos

Exceções

Comentários

Notas aos Chamadores

Confira também

Aplica-se a

Insert(Int32, UInt32)

Parâmetros

Retornos

Exceções

Comentários

Notas aos Chamadores

Confira também

Aplica-se a

Insert(Int32, UInt16)

Parâmetros

Retornos

Exceções

Comentários

Notas aos Chamadores

Confira também

Aplica-se a

Insert(Int32, String)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Insert(Int32, Single)

Parâmetros

Retornos

Exceções

Comentários

Notas aos Chamadores

Confira também

Aplica-se a

Insert(Int32, ReadOnlySpan<Char>)

Parâmetros

Retornos

Comentários

Aplica-se a

Insert(Int32, Int16)

Parâmetros

Retornos

Exceções

Comentários

Notas aos Chamadores

Confira também

Aplica-se a

Insert(Int32, Int64)

Parâmetros