Partager via


StringBuilder.Insert Méthode

Définition

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un objet spécifié.

Surcharges

Insert(Int32, SByte)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier signé 8 bits spécifié.

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

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un sous-tableau de caractères Unicode spécifié.

Insert(Int32, String, Int32)

Insère dans cette instance une ou plusieurs copies d'une chaîne spécifiée, à la position de caractère spécifiée.

Insert(Int32, UInt64)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier non signé 64 bits.

Insert(Int32, UInt32)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier non signé 32 bits.

Insert(Int32, UInt16)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier non signé 16 bits.

Insert(Int32, String)

Insère une chaîne dans cette instance, à la position de caractère spécifiée.

Insert(Int32, Single)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un nombre à virgule flottante simple précision.

Insert(Int32, ReadOnlySpan<Char>)

Insère la séquence de caractères dans cette instance, à la position de caractère spécifiée.

Insert(Int32, Int16)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier signé 16 bits spécifié.

Insert(Int32, Int64)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier signé de 64 bits.

Insert(Int32, Int32)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier signé 32 bits spécifié.

Insert(Int32, Object)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un objet.

Insert(Int32, Double)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un nombre à virgule flottante double précision.

Insert(Int32, Decimal)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un nombre décimal.

Insert(Int32, Char[])

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un tableau de caractères Unicode spécifié.

Insert(Int32, Char)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un caractère Unicode spécifié.

Insert(Int32, Byte)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier non signé de 8 bits spécifié.

Insert(Int32, Boolean)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'une valeur booléenne.

Exemples

L’exemple suivant illustre la Insert méthode.

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

Important

Cette API n’est pas conforme CLS.

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier signé 8 bits spécifié.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
SByte

Valeur à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Attributs

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

SByte.ToString est utilisé pour obtenir une représentation sous forme de chaîne de value. Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité est ajustée en fonction des besoins.

Notes pour les appelants

Dans .NET Framework 3.5 Service Pack 1 et versions antérieures, les appels à cette méthode ont levé un ArgumentOutOfRangeException si l’insertion value entraînait un dépassement de la longueur MaxCapacitytotale de l’objet . À compter du .NET Framework 4, la méthode lève un OutOfMemoryException.

Voir aussi

S’applique à

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

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

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un sous-tableau de caractères Unicode spécifié.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
Char[]

Tableau de caractères.

startIndex
Int32

Index de départ dans value.

charCount
Int32

Nombre de caractères à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Exceptions

value a la valeur null, tandis que startIndex et charCount sont différents de zéro.

index, startIndex ou charCount est inférieur à zéro.

- ou -

index est supérieur à la longueur de cette instance.

- ou -

startIndex plus charCount n’est pas une position dans value.

- ou -

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de cette instance est ajustée en fonction des besoins.

S’applique à

Insert(Int32, String, Int32)

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

Insère dans cette instance une ou plusieurs copies d'une chaîne spécifiée, à la position de caractère spécifiée.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
String

Chaîne à insérer.

count
Int32

Nombre d'insertions de value à effectuer.

Retours

Référence à cette instance après l'opération d'insertion.

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

- ou -

count est inférieur à zéro.

La longueur actuelle de cet objet StringBuilder plus la longueur de value fois count dépasse MaxCapacity.

Remarques

Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de cette instance est ajustée en fonction des besoins.

Cet StringBuilder objet n’est pas modifié si value a la valeur null, value n’est pas null , mais sa longueur est égale à zéro ou count à zéro.

Voir aussi

S’applique à

Insert(Int32, UInt64)

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

Important

Cette API n’est pas conforme CLS.

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier non signé 64 bits.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
UInt64

Valeur à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Attributs

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

UInt64.ToString est utilisé pour obtenir une représentation sous forme de chaîne de value. Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de cette instance est ajustée en fonction des besoins.

Notes pour les appelants

Dans .NET Framework 3.5 Service Pack 1 et versions antérieures, les appels à cette méthode ont levé un ArgumentOutOfRangeException si l’insertion value entraînait un dépassement de la longueur MaxCapacitytotale de l’objet . À compter du .NET Framework 4, la méthode lève un OutOfMemoryException.

Voir aussi

S’applique à

Insert(Int32, UInt32)

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

Important

Cette API n’est pas conforme CLS.

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier non signé 32 bits.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
UInt32

Valeur à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Attributs

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

UInt32.ToString est utilisé pour obtenir une représentation sous forme de chaîne de value. Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de ce instance est ajustée en fonction des besoins.

Notes pour les appelants

Dans .NET Framework 3.5 Service Pack 1 et versions antérieures, les appels à cette méthode ont levé un ArgumentOutOfRangeException si l’insertion value entraînait un dépassement de la longueur MaxCapacitytotale de l’objet . À compter du .NET Framework 4, la méthode lève un OutOfMemoryException.

Voir aussi

S’applique à

Insert(Int32, UInt16)

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

Important

Cette API n’est pas conforme CLS.

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier non signé 16 bits.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
UInt16

Valeur à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Attributs

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

UInt16.ToString est utilisé pour obtenir une représentation sous forme de chaîne de value. Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de ce instance est ajustée en fonction des besoins.

Notes pour les appelants

Dans .NET Framework 3.5 Service Pack 1 et versions antérieures, les appels à cette méthode lançaient un ArgumentOutOfRangeException si l’insertion value entraînerait le dépassement MaxCapacityde la longueur totale de l’objet . À compter de .NET Framework 4, la méthode lève un OutOfMemoryException.

Voir aussi

S’applique à

Insert(Int32, String)

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

Insère une chaîne dans cette instance, à la position de caractère spécifiée.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
String

Chaîne à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

- ou -

La longueur actuelle de cet objet StringBuilder plus la longueur de value dépasse MaxCapacity.

Remarques

Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité est ajustée en fonction des besoins.

Cette instance de n’est StringBuilder pas modifiée si value a la valeur nullou value n’est pasnull, mais sa longueur est égale à zéro.

Voir aussi

S’applique à

Insert(Int32, Single)

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

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un nombre à virgule flottante simple précision.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
Single

Valeur à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Single.ToString est utilisé pour obtenir une représentation sous forme de chaîne de value. Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de ce instance est ajustée en fonction des besoins.

Notes pour les appelants

Dans .NET Framework 3.5 Service Pack 1 et versions antérieures, les appels à cette méthode lançaient un ArgumentOutOfRangeException si l’insertion value entraînerait le dépassement MaxCapacityde la longueur totale de l’objet . À compter de .NET Framework 4, la méthode lève un OutOfMemoryException.

Voir aussi

S’applique à

Insert(Int32, ReadOnlySpan<Char>)

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

Insère la séquence de caractères dans cette instance, à la position de caractère spécifiée.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
ReadOnlySpan<Char>

Plage de caractères à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Remarques

Les caractères existants sont décalés pour faire de l’espace pour la séquence de caractères dans le afin de l’insérer value . La capacité est ajustée en fonction des besoins.

S’applique à

Insert(Int32, Int16)

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

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier signé 16 bits spécifié.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
Int16

Valeur à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Int16.ToString est utilisé pour obtenir une représentation sous forme de chaîne de value. Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de ce instance est ajustée en fonction des besoins.

Notes pour les appelants

Dans .NET Framework 3.5 Service Pack 1 et versions antérieures, les appels à cette méthode lançaient un ArgumentOutOfRangeException si l’insertion value entraînerait le dépassement MaxCapacityde la longueur totale de l’objet . À compter de .NET Framework 4, la méthode lève un OutOfMemoryException.

Voir aussi

S’applique à

Insert(Int32, Int64)

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

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier signé de 64 bits.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
Int64

Valeur à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Int64.ToString est utilisé pour obtenir une représentation sous forme de chaîne de value. Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de ce instance est ajustée en fonction des besoins.

Notes pour les appelants

Dans .NET Framework 3.5 Service Pack 1 et versions antérieures, les appels à cette méthode lançaient un ArgumentOutOfRangeException si l’insertion value entraînerait le dépassement MaxCapacityde la longueur totale de l’objet . À compter de .NET Framework 4, la méthode lève un OutOfMemoryException.

Voir aussi

S’applique à

Insert(Int32, Int32)

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

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier signé 32 bits spécifié.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
Int32

Valeur à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Int32.ToString est utilisé pour obtenir une représentation sous forme de chaîne de value. Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de ce instance est ajustée en fonction des besoins.

Notes pour les appelants

Dans .NET Framework 3.5 Service Pack 1 et versions antérieures, les appels à cette méthode lançaient un ArgumentOutOfRangeException si l’insertion value entraînerait le dépassement MaxCapacityde la longueur totale de l’objet . À compter de .NET Framework 4, la méthode lève un OutOfMemoryException.

Voir aussi

S’applique à

Insert(Int32, Object)

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

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un objet.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
Object

Objet à insérer ou null.

Retours

Référence à cette instance après l'opération d'insertion.

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Object.ToString est utilisé pour obtenir une représentation sous forme de chaîne de value. Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de ce instance est ajustée en fonction des besoins.

Si value a nullla valeur , la valeur de cette instance est inchangée.

Notes pour les appelants

Dans .NET Framework 3.5 Service Pack 1 et versions antérieures, les appels à cette méthode lançaient un ArgumentOutOfRangeException si l’insertion value entraînerait le dépassement MaxCapacityde la longueur totale de l’objet . À compter de .NET Framework 4, la méthode lève un OutOfMemoryException.

Voir aussi

S’applique à

Insert(Int32, Double)

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

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un nombre à virgule flottante double précision.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
Double

Valeur à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Double.ToString est utilisé pour obtenir une représentation sous forme de chaîne de value. Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de ce instance est ajustée en fonction des besoins.

Notes pour les appelants

Dans .NET Framework 3.5 Service Pack 1 et versions antérieures, les appels à cette méthode lançaient un ArgumentOutOfRangeException si l’insertion value entraînerait le dépassement MaxCapacityde la longueur totale de l’objet . À compter de .NET Framework 4, la méthode lève un OutOfMemoryException.

Voir aussi

S’applique à

Insert(Int32, Decimal)

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

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un nombre décimal.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
Decimal

Valeur à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Decimal.ToString est utilisé pour obtenir une représentation sous forme de chaîne de value. Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de cette instance est ajustée en fonction des besoins.

Notes pour les appelants

Dans .NET Framework 3.5 Service Pack 1 et versions antérieures, les appels à cette méthode lançaient un ArgumentOutOfRangeException si l’insertion value entraînerait le dépassement MaxCapacityde la longueur totale de l’objet . À compter du .NET Framework 4, la méthode lève un OutOfMemoryException.

Voir aussi

S’applique à

Insert(Int32, Char[])

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

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un tableau de caractères Unicode spécifié.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
Char[]

Tableau de caractères à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

- ou -

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de cette instance est ajustée en fonction des besoins.

Si value a la valeur null, le n’est StringBuilder pas modifié.

S’applique à

Insert(Int32, Char)

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

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un caractère Unicode spécifié.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
Char

Valeur à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

- ou -

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Char.ToString est utilisé pour obtenir une représentation sous forme de chaîne de value. Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de cette instance est ajustée en fonction des besoins.

Voir aussi

S’applique à

Insert(Int32, Byte)

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

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier non signé de 8 bits spécifié.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
Byte

Valeur à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Byte.ToString est utilisé pour obtenir une représentation sous forme de chaîne de value. Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité de cette instance est ajustée en fonction des besoins.

Notes pour les appelants

Dans .NET Framework 3.5 Service Pack 1 et versions antérieures, les appels à cette méthode ont levé un ArgumentOutOfRangeException si l’insertion value entraînait un dépassement de la longueur MaxCapacitytotale de l’objet . À compter du .NET Framework 4, la méthode lève un OutOfMemoryException.

Voir aussi

S’applique à

Insert(Int32, Boolean)

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

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'une valeur booléenne.

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

Paramètres

index
Int32

Position dans cette instance où commence l'insertion.

value
Boolean

Valeur à insérer.

Retours

Référence à cette instance après l'opération d'insertion.

Exceptions

index est inférieur à zéro ou supérieur à la longueur de cette instance.

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Boolean.ToString est utilisé pour obtenir une représentation sous forme de chaîne de value. Les caractères existants sont déplacés pour faire de la place pour le nouveau texte. La capacité est ajustée en fonction des besoins.

Notes pour les appelants

Dans .NET Framework 3.5 Service Pack 1 et versions antérieures, les appels à cette méthode ont levé un ArgumentOutOfRangeException si l’insertion value entraînait un dépassement de la longueur MaxCapacitytotale de l’objet . À compter du .NET Framework 4, la méthode lève un OutOfMemoryException.

Voir aussi

S’applique à