StringBuilder.Insert Método

Definição

Espaço de Nomes:: System.Text

Assemblagens:: mscorlib.dll, System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Insere a representação da cadeia de um objeto especificado nesta instância numa posição de carácter especificada.

Sobrecargas

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

Exemplos

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

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

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 neste caso onde a inserção começa.

value: String

O fio para inserir.

count: Int32

O número de vezes a inserir value.

Devoluções

StringBuilder

Uma referência a esta instância após a inserção estar concluída.

Exceções

ArgumentOutOfRangeException

index é inferior a zero ou superior ao comprimento atual desta instância.

-ou-

count é inferior a zero.

OutOfMemoryException

O comprimento atual deste StringBuilder objeto mais o comprimento dos value tempos count excede MaxCapacity.

Observações

As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

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

Ver também

String

Aplica-se a

Insert(Int32, UInt64)

Importante

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

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

A posição neste caso onde a inserção começa.

value: UInt64

O valor a inserir.

Devoluções

StringBuilder

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

Atributos: CLSCompliantAttribute

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

OutOfMemoryException

Aumentar o valor desta instância excederia MaxCapacity.

Observações

UInt64.ToString é usado para obter uma representação de cadeias de value. As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

Notas para Chamadores

No .NET Framework 3.5 Service Pack 1 e versões anteriores, as chamadas a este método lançavam um ArgumentOutOfRangeException se inserir value fizesse com que o comprimento total do objeto ultrapassasse MaxCapacity. A partir do .NET Framework 4, o método gera um OutOfMemoryException.

Ver também

UInt64

Aplica-se a

Insert(Int32, UInt32)

Importante

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

Insere a representação da cadeia de um inteiro sem sinal de 32 bits nesta instância na posição especificada do carácter.

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 neste caso onde a inserção começa.

value: UInt32

O valor a inserir.

Devoluções

StringBuilder

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

Atributos: CLSCompliantAttribute

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

OutOfMemoryException

Aumentar o valor desta instância excederia MaxCapacity.

Observações

UInt32.ToString é usado para obter uma representação de cadeias de value. As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

Notas para Chamadores

Ver também

UInt32

Aplica-se a

Insert(Int32, UInt16)

Importante

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

Insere a representação da cadeia de um inteiro sem sinal de 16 bits nesta instância na posição especificada do caractere.

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 neste caso onde a inserção começa.

value: UInt16

O valor a inserir.

Devoluções

StringBuilder

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

Atributos: CLSCompliantAttribute

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

OutOfMemoryException

Aumentar o valor desta instância excederia MaxCapacity.

Observações

UInt16.ToString é usado para obter uma representação de cadeias de value. As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

Notas para Chamadores

Ver também

UInt16

Aplica-se a

Insert(Int32, String)

Insere uma cadeia nesta instância na posição do carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, System::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 neste caso onde a inserção começa.

value: String

O fio para inserir.

Devoluções

StringBuilder

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

Exceções

ArgumentOutOfRangeException

index é inferior a zero ou superior ao comprimento atual desta instância.

-ou-

O comprimento atual deste StringBuilder objeto mais o comprimento de value excede MaxCapacity.

Observações

As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade é ajustada conforme necessário.

Esta instância de StringBuilder não é alterada se value for null, ou value não null for mas o seu comprimento for zero.

Ver também

String

Aplica-se a

Insert(Int32, Single)

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

A posição neste caso onde a inserção começa.

value: Single

O valor a inserir.

Devoluções

StringBuilder

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

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

OutOfMemoryException

Aumentar o valor desta instância excederia MaxCapacity.

Observações

Single.ToString é usado para obter uma representação de cadeias de value. As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

Notas para Chamadores

Ver também

Single

Aplica-se a

Insert(Int32, SByte)

Importante

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

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

A posição neste caso onde a inserção começa.

value: SByte

O valor a inserir.

Devoluções

StringBuilder

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

Atributos: CLSCompliantAttribute

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

OutOfMemoryException

Aumentar o valor desta instância excederia MaxCapacity.

Observações

SByte.ToString é usado para obter uma representação de cadeias de value. As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade é ajustada conforme necessário.

Notas para Chamadores

Ver também

SByte

Aplica-se a

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

Insere a representação da cadeia de um subarray especificado de caracteres Unicode nesta instância na posição especificada dos caracteres.

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

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 neste caso onde a inserção começa.

value: Char[]

Um conjunto de caracteres.

startIndex: Int32

O índice inicial dentro de value.

charCount: Int32

O número de caracteres a inserir.

Devoluções

StringBuilder

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

Exceções

ArgumentNullException

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

ArgumentOutOfRangeException

index, startIndex, ou charCount é inferior a zero.

-ou-

index é maior do que o comprimento desta instância.

-ou-

startIndex Plus charCount não é uma posição dentro valuede .

-ou-

Aumentar o valor desta instância excederia MaxCapacity.

Observações

As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

Aplica-se a

Insert(Int32, ReadOnlySpan<Char>)

Insere a sequência de caracteres nesta instância na posição especificada do caractere.

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 neste caso onde a inserção começa.

value: ReadOnlySpan<Char>

A extensão do carácter para inserir.

Devoluções

StringBuilder

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

Observações

Os caracteres existentes são deslocados para dar espaço à sequência de personagens em e value para a inserir. A capacidade é ajustada conforme necessário.

Aplica-se a

Insert(Int32, Int32)

Insere a representação da string de um inteiro assinado especificado de 32 bits nesta instância na posição do 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

A posição neste caso onde a inserção começa.

value: Int32

O valor a inserir.

Devoluções

StringBuilder

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

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

OutOfMemoryException

Aumentar o valor desta instância excederia MaxCapacity.

Observações

Int32.ToString é usado para obter uma representação de cadeias de value. As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

Notas para Chamadores

Ver também

Int32

Aplica-se a

Insert(Int32, Int64)

Insere a representação da cadeia de um inteiro com sinal de 64 bits nesta instância na posição especificada do caractere.

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 neste caso onde a inserção começa.

value: Int64

O valor a inserir.

Devoluções

StringBuilder

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

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

OutOfMemoryException

Aumentar o valor desta instância excederia MaxCapacity.

Observações

Int64.ToString é usado para obter uma representação de cadeias de value. As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

Notas para Chamadores

Ver também

Int64

Aplica-se a

Insert(Int32, Int16)

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

A posição neste caso onde a inserção começa.

value: Int16

O valor a inserir.

Devoluções

StringBuilder

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

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

OutOfMemoryException

Aumentar o valor desta instância excederia MaxCapacity.

Observações

Int16.ToString é usado para obter uma representação de cadeias de value. As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

Notas para Chamadores

Ver também

Int16

Aplica-se a

Insert(Int32, Double)

Insere a representação da string de um número de ponto flutuante de dupla precisão nesta instância na posição especificada do caractere.

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 neste caso onde a inserção começa.

value: Double

O valor a inserir.

Devoluções

StringBuilder

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

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

OutOfMemoryException

Aumentar o valor desta instância excederia MaxCapacity.

Observações

Double.ToString é usado para obter uma representação de cadeias de value. As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

Notas para Chamadores

Ver também

Double

Aplica-se a

Insert(Int32, Decimal)

Insere a representação da cadeia de um número decimal nesta instância na posição especificada do carácter.

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 neste caso onde a inserção começa.

value: Decimal

O valor a inserir.

Devoluções

StringBuilder

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

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

OutOfMemoryException

Aumentar o valor desta instância excederia MaxCapacity.

Observações

Decimal.ToString é usado para obter uma representação de cadeias de value. As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

Notas para Chamadores

Ver também

Decimal

Aplica-se a

Insert(Int32, Char[])

Insere a representação da cadeia de um array especificado de caracteres Unicode nesta instância na posição especificada dos caracteres.

public:
 System::Text::StringBuilder ^ Insert(int index, cli::array <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 neste caso onde a inserção começa.

value: Char[]

O array de caracteres a inserir.

Devoluções

StringBuilder

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

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

-ou-

Aumentar o valor desta instância excederia MaxCapacity.

Observações

As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

Se value for null, o StringBuilder não é alterado.

Aplica-se a

Insert(Int32, Char)

Insere a representação da cadeia de um carácter Unicode especificado nesta instância na posição do 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

A posição neste caso onde a inserção começa.

value: Char

O valor a inserir.

Devoluções

StringBuilder

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

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

-ou-

Aumentar o valor desta instância excederia MaxCapacity.

Observações

Char.ToString é usado para obter uma representação de cadeias de value. As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

Ver também

Char

Aplica-se a

Insert(Int32, Byte)

Insere a representação da cadeia de um inteiro não assinado especificado de 8 bits nesta instância na posição do 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

A posição neste caso onde a inserção começa.

value: Byte

O valor a inserir.

Devoluções

StringBuilder

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

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

OutOfMemoryException

Aumentar o valor desta instância excederia MaxCapacity.

Observações

Byte.ToString é usado para obter uma representação de cadeias de value. As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

Notas para Chamadores

Ver também

Byte

Aplica-se a

Insert(Int32, Boolean)

Insere a representação da cadeia de um valor booleano nesta instância na posição especificada do caractere.

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 neste caso onde a inserção começa.

value: Boolean

O valor a inserir.

Devoluções

StringBuilder

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

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

OutOfMemoryException

Aumentar o valor desta instância excederia MaxCapacity.

Observações

Boolean.ToString é usado para obter uma representação de cadeias de value. As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade é ajustada conforme necessário.

Notas para Chamadores

Ver também

Boolean

Aplica-se a

Insert(Int32, Object)

Insere a representação string de um objeto nesta instância na posição de carácter especificada.

public:
 System::Text::StringBuilder ^ Insert(int index, System::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 neste caso onde a inserção começa.

value: Object

O objeto a inserir, ou null.

Devoluções

StringBuilder

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

Exceções

ArgumentOutOfRangeException

index é menor que zero ou superior ao comprimento desta instância.

OutOfMemoryException

Aumentar o valor desta instância excederia MaxCapacity.

Observações

Object.ToString é usado para obter uma representação de cadeias de value. As personagens existentes são deslocadas para dar lugar ao novo texto. A capacidade desta instância é ajustada conforme necessário.

Se value for null, o valor desta instância permanece inalterado.

Notas para Chamadores

Ver também

Object

Aplica-se a

Comentários

Esta página foi útil?