StringBuilder.Insert Metodo

Definizione

Inserisce la rappresentazione di stringa di un oggetto specificato in questa istanza in una posizione del carattere specificata.

Overload

Insert(Int32, String)

Inserisce una stringa in questa istanza nella posizione del carattere specificata.

Insert(Int32, Single)

Inserisce la rappresentazione di stringa di un numero a virgola mobile a precisione singola in questa istanza nella posizione del carattere specificata.

Insert(Int32, UInt16)

Inserisce la rappresentazione di stringa di un intero senza segno a 16 bit in questa istanza nella posizione del carattere specificata.

Insert(Int32, Int16)

Inserisce la rappresentazione di stringa di un intero con segno a 16 bit specificato in questa istanza nella posizione del carattere specificata.

Insert(Int32, UInt64)

Inserisce la rappresentazione di stringa di un intero senza segno a 64 bit in questa istanza nella posizione del carattere specificata.

Insert(Int32, String, Int32)

Inserisce una o più copie di una stringa specificata in questa istanza nella posizione del carattere specificata.

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

Inserisce la rappresentazione di stringa di una sottomatrice specificata di caratteri Unicode in questa istanza nella posizione del carattere specificata.

Insert(Int32, SByte)

Inserisce la rappresentazione di stringa di un intero con segno a 8 bit specificato in questa istanza nella posizione del carattere specificata.

Insert(Int32, UInt32)

Inserisce la rappresentazione di stringa di un intero senza segno a 32 bit in questa istanza nella posizione del carattere specificata.

Insert(Int32, ReadOnlySpan<Char>)

Inserisce la sequenza di caratteri in questa istanza nella posizione del carattere specificata.

Insert(Int32, Double)

Inserisce la rappresentazione di stringa di un numero a virgola mobile a precisione doppia in questa istanza nella posizione del carattere specificata.

Insert(Int32, Int64)

Inserisce la rappresentazione di stringa di un intero con segno a 64 bit in questa istanza nella posizione del carattere specificata.

Insert(Int32, Int32)

Inserisce la rappresentazione di stringa di un intero con segno a 32 bit specificato in questa istanza nella posizione del carattere specificata.

Insert(Int32, Object)

Inserisce la rappresentazione di stringa di un oggetto in questa istanza nella posizione del carattere specificata.

Insert(Int32, Decimal)

Inserisce la rappresentazione di stringa di un numero decimale in questa istanza nella posizione del carattere specificata.

Insert(Int32, Char[])

Inserisce la rappresentazione di stringa di una matrice specificata di caratteri Unicode in questa istanza nella posizione del carattere specificata.

Insert(Int32, Char)

Inserisce la rappresentazione di stringa di un carattere Unicode specificato in questa istanza nella posizione del carattere specificata.

Insert(Int32, Byte)

Inserisce la rappresentazione di stringa di un intero senza segno a 8 bit specificato in questa istanza nella posizione del carattere specificata.

Insert(Int32, Boolean)

Inserisce la rappresentazione di stringa di un valore booleano in questa istanza nella posizione del carattere specificata.

Esempio

Nell'esempio seguente viene illustrato il Insert metodo.

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, String)

Inserisce una stringa in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
String

Stringa da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Eccezioni

index è minore di zero o maggiore della lunghezza corrente di questa istanza.

-oppure-

La somma della lunghezza corrente di questo oggetto StringBuilder e della lunghezza di value è superiore a MaxCapacity.

Commenti

I caratteri esistenti vengono spostati per fare spazio al nuovo testo. La capacità viene modificata in base alle esigenze.

Questa istanza di StringBuilder non viene modificata se value è nullo non null è ma value la lunghezza è zero.

Vedi anche

Si applica a

Insert(Int32, Single)

Inserisce la rappresentazione di stringa di un numero a virgola mobile a precisione singola in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
Single

Valore da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Single.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per fare spazio al nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Framework 3.5 Service Pack 1 e versioni precedenti, le chiamate a questo metodo generano un'eccezione ArgumentOutOfRangeException se l'inserimento value provocherebbe il superamento MaxCapacitydella lunghezza totale dell'oggetto. A partire da .NET Framework 4, il metodo genera un'eccezione OutOfMemoryException.

Vedi anche

Si applica a

Insert(Int32, UInt16)

Importante

Questa API non è conforme a CLS.

Inserisce la rappresentazione di stringa di un intero senza segno a 16 bit in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
UInt16

Valore da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Attributi

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

UInt16.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per fare spazio al nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Framework 3.5 Service Pack 1 e versioni precedenti, le chiamate a questo metodo generano un'eccezione ArgumentOutOfRangeException se l'inserimento value provocherebbe il superamento MaxCapacitydella lunghezza totale dell'oggetto. A partire da .NET Framework 4, il metodo genera un'eccezione OutOfMemoryException.

Vedi anche

Si applica a

Insert(Int32, Int16)

Inserisce la rappresentazione di stringa di un intero con segno a 16 bit specificato in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
Int16

Valore da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Int16.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per fare spazio al nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Framework 3.5 Service Pack 1 e versioni precedenti, le chiamate a questo metodo generano un'eccezione ArgumentOutOfRangeException se l'inserimento value provocherebbe il superamento MaxCapacitydella lunghezza totale dell'oggetto. A partire da .NET Framework 4, il metodo genera un'eccezione OutOfMemoryException.

Vedi anche

Si applica a

Insert(Int32, UInt64)

Importante

Questa API non è conforme a CLS.

Inserisce la rappresentazione di stringa di un intero senza segno a 64 bit in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
UInt64

Valore da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Attributi

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

UInt64.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per fare spazio al nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Framework 3.5 Service Pack 1 e versioni precedenti, le chiamate a questo metodo generano un'eccezione ArgumentOutOfRangeException se l'inserimento value provocherebbe il superamento MaxCapacitydella lunghezza totale dell'oggetto. A partire da .NET Framework 4, il metodo genera un'eccezione OutOfMemoryException.

Vedi anche

Si applica a

Insert(Int32, String, Int32)

Inserisce una o più copie di una stringa specificata in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
String

Stringa da inserire.

count
Int32

Numero delle operazioni di inserimento di value.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Eccezioni

index è minore di zero o maggiore della lunghezza corrente di questa istanza.

-oppure-

count è minore di zero.

La somma della lunghezza corrente di questo oggetto StringBuilder e della lunghezza di value moltiplicata per count è superiore a MaxCapacity.

Commenti

I caratteri esistenti vengono spostati per rendere spazio per il nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Questo StringBuilder oggetto non viene modificato se value è null, non null è ma value la lunghezza è zero o count è zero.

Vedi anche

Si applica a

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

Inserisce la rappresentazione di stringa di una sottomatrice specificata di caratteri Unicode in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
Char[]

Matrice di caratteri.

startIndex
Int32

Indice iniziale all'interno di value.

charCount
Int32

Numero di caratteri da scrivere.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Eccezioni

value è null e startIndex e charCount sono diversi da zero.

index, startIndex o charCount è minore di zero.

-oppure-

index è maggiore della lunghezza di questa istanza.

-oppure-

La somma di startIndex e charCount non corrisponde a una posizione all'interno di value.

-oppure-

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

I caratteri esistenti vengono spostati per rendere spazio per il nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Si applica a

Insert(Int32, SByte)

Importante

Questa API non è conforme a CLS.

Inserisce la rappresentazione di stringa di un intero con segno a 8 bit specificato in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
SByte

Valore da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Attributi

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

SByte.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per rendere spazio per il nuovo testo. La capacità viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Framework 3.5 Service Pack 1 e versioni precedenti, le chiamate a questo metodo generano un ArgumentOutOfRangeException se l'inserimento value causerebbe il superamento MaxCapacitydella lunghezza totale dell'oggetto. A partire da .NET Framework 4, il metodo genera un OutOfMemoryExceptionoggetto .

Vedi anche

Si applica a

Insert(Int32, UInt32)

Importante

Questa API non è conforme a CLS.

Inserisce la rappresentazione di stringa di un intero senza segno a 32 bit in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
UInt32

Valore da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Attributi

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

UInt32.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per rendere spazio per il nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Framework 3.5 Service Pack 1 e versioni precedenti, le chiamate a questo metodo generano un ArgumentOutOfRangeException se l'inserimento value causerebbe il superamento MaxCapacitydella lunghezza totale dell'oggetto. A partire da .NET Framework 4, il metodo genera un OutOfMemoryExceptionoggetto .

Vedi anche

Si applica a

Insert(Int32, ReadOnlySpan<Char>)

Inserisce la sequenza di caratteri in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
ReadOnlySpan<Char>

Intervallo di caratteri da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Commenti

I caratteri esistenti vengono spostati per rendere disponibile la sequenza di caratteri nell'oggetto value da inserire. La capacità viene modificata in base alle esigenze.

Si applica a

Insert(Int32, Double)

Inserisce la rappresentazione di stringa di un numero a virgola mobile a precisione doppia in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
Double

Valore da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Double.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per rendere spazio per il nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Framework 3.5 Service Pack 1 e versioni precedenti, le chiamate a questo metodo generano un ArgumentOutOfRangeException se l'inserimento value causerebbe il superamento MaxCapacitydella lunghezza totale dell'oggetto. A partire da .NET Framework 4, il metodo genera un OutOfMemoryExceptionoggetto .

Vedi anche

Si applica a

Insert(Int32, Int64)

Inserisce la rappresentazione di stringa di un intero con segno a 64 bit in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
Int64

Valore da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Int64.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per rendere spazio per il nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Framework 3.5 Service Pack 1 e versioni precedenti, le chiamate a questo metodo generano un ArgumentOutOfRangeException se l'inserimento value causerebbe il superamento MaxCapacitydella lunghezza totale dell'oggetto. A partire da .NET Framework 4, il metodo genera un OutOfMemoryExceptionoggetto .

Vedi anche

Si applica a

Insert(Int32, Int32)

Inserisce la rappresentazione di stringa di un intero con segno a 32 bit specificato in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
Int32

Valore da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Int32.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per rendere spazio per il nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Framework 3.5 Service Pack 1 e versioni precedenti, le chiamate a questo metodo generano un ArgumentOutOfRangeException se l'inserimento value causerebbe il superamento MaxCapacitydella lunghezza totale dell'oggetto. A partire da .NET Framework 4, il metodo genera un OutOfMemoryExceptionoggetto .

Vedi anche

Si applica a

Insert(Int32, Object)

Inserisce la rappresentazione di stringa di un oggetto in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
Object

Oggetto da inserire o null.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Object.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per rendere spazio per il nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Se value è null, il valore di questa istanza è invariato.

Note per i chiamanti

In .NET Framework 3.5 Service Pack 1 e versioni precedenti, le chiamate a questo metodo generano un ArgumentOutOfRangeException se l'inserimento value causerebbe il superamento MaxCapacitydella lunghezza totale dell'oggetto. A partire da .NET Framework 4, il metodo genera un OutOfMemoryExceptionoggetto .

Vedi anche

Si applica a

Insert(Int32, Decimal)

Inserisce la rappresentazione di stringa di un numero decimale in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
Decimal

Valore da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Decimal.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per rendere spazio per il nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Framework 3.5 Service Pack 1 e versioni precedenti, le chiamate a questo metodo generano un ArgumentOutOfRangeException se l'inserimento value causerebbe il superamento MaxCapacitydella lunghezza totale dell'oggetto. A partire da .NET Framework 4, il metodo genera un OutOfMemoryExceptionoggetto .

Vedi anche

Si applica a

Insert(Int32, Char[])

Inserisce la rappresentazione di stringa di una matrice specificata di caratteri Unicode in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
Char[]

Matrice di caratteri da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

-oppure-

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

I caratteri esistenti vengono spostati per rendere spazio per il nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Se value è null, l'oggetto StringBuilder non viene modificato.

Si applica a

Insert(Int32, Char)

Inserisce la rappresentazione di stringa di un carattere Unicode specificato in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
Char

Valore da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

-oppure-

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Char.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per rendere spazio per il nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Vedi anche

Si applica a

Insert(Int32, Byte)

Inserisce la rappresentazione di stringa di un intero senza segno a 8 bit specificato in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
Byte

Valore da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Byte.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per rendere spazio per il nuovo testo. La capacità di questa istanza viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Framework 3.5 Service Pack 1 e versioni precedenti, le chiamate a questo metodo generano un ArgumentOutOfRangeException se l'inserimento value causerebbe il superamento MaxCapacitydella lunghezza totale dell'oggetto. A partire da .NET Framework 4, il metodo genera un OutOfMemoryExceptionoggetto .

Vedi anche

Si applica a

Insert(Int32, Boolean)

Inserisce la rappresentazione di stringa di un valore booleano in questa istanza nella posizione del carattere specificata.

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

Parametri

index
Int32

Posizione in questa istanza in cui inizia l'inserimento.

value
Boolean

Valore da inserire.

Restituisce

Riferimento a questa istanza dopo il completamento dell'operazione di inserimento.

Eccezioni

index è minore di zero o maggiore della lunghezza di questa istanza.

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Boolean.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per rendere spazio per il nuovo testo. La capacità viene modificata in base alle esigenze.

Note per i chiamanti

In .NET Framework 3.5 Service Pack 1 e versioni precedenti, le chiamate a questo metodo generano un ArgumentOutOfRangeException se l'inserimento value causerebbe il superamento MaxCapacitydella lunghezza totale dell'oggetto. A partire da .NET Framework 4, il metodo genera un OutOfMemoryExceptionoggetto .

Vedi anche

Si applica a