StringBuilder.Insert Metodo

Definizione

Spazio dei nomi:

System.Text

Assembly:

netstandard.dll, System.Runtime.dll

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

Overload

Nome	Descrizione
Insert(Int32, String, Int32)	Inserisce una o più copie di una stringa specificata in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, UInt64)	Inserisce la rappresentazione di stringa di un intero senza segno a 64 bit in questa istanza in corrispondenza della 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, UInt16)	Inserisce la rappresentazione di stringa di un intero senza segno a 16 bit in questa istanza nella posizione del carattere specificata.
Insert(Int32, String)	Inserisce una stringa in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Char[], Int32, Int32)	Inserisce la rappresentazione di stringa di una sottoarray specificata di caratteri Unicode in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Single)	Inserisce la rappresentazione di stringa di un numero a virgola mobile a precisione singola in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, SByte)	Inserisce la rappresentazione di stringa di un intero con segno a 8 bit specificato in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, ReadOnlySpan<Char>)	Inserisce la sequenza di caratteri in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Int16)	Inserisce la rappresentazione di stringa di un intero con segno a 16 bit specificato in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Int64)	Inserisce la rappresentazione di stringa di un intero con segno a 64 bit in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Int32)	Inserisce la rappresentazione di stringa di un intero con segno a 32 bit specificato in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Double)	Inserisce la rappresentazione di stringa di un numero a virgola mobile e precisione doppia in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Decimal)	Inserisce la rappresentazione di stringa di un numero decimale in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Char[])	Inserisce la rappresentazione di stringa di una matrice di caratteri Unicode specificata in questa istanza in corrispondenza della 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 in corrispondenza della posizione del carattere specificata.
Insert(Int32, Boolean)	Inserisce la rappresentazione di stringa di un valore booleano in questa istanza in corrispondenza della posizione del carattere specificata.
Insert(Int32, Object)	Inserisce la rappresentazione di stringa di un oggetto in questa istanza in corrispondenza della posizione del carattere specificata.

Esempio

Nell'esempio seguente viene illustrato il Insert metodo .

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)

Origine:

StringBuilder.cs

Inserisce una o più copie di una stringa specificata in questa istanza in corrispondenza della 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);

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 di volte in cui inserire value.

Restituisce

StringBuilder

Riferimento a questa istanza dopo il completamento dell'inserimento.

Eccezioni

ArgumentOutOfRangeException

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

oppure

count è minore di zero.

OutOfMemoryException

La lunghezza corrente di questo StringBuilder oggetto più la lunghezza dei value tempi count supera MaxCapacity.

Commenti

I caratteri esistenti vengono spostati per liberare 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, value non null è ma la lunghezza è zero o count è zero.

Vedi anche

• String

Insert(Int32, UInt64)

Origine:

StringBuilder.cs

Importante

Questa API non è conforme a CLS.

Inserisce la rappresentazione di stringa di un intero senza segno a 64 bit in questa istanza in corrispondenza della 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

StringBuilder

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

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentOutOfRangeException

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

OutOfMemoryException

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

UInt64.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per liberare 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'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

• UInt64

Insert(Int32, UInt32)

Origine:

StringBuilder.cs

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

StringBuilder

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

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentOutOfRangeException

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

OutOfMemoryException

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

UInt32.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per liberare 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'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

• UInt32

Insert(Int32, UInt16)

Origine:

StringBuilder.cs

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

StringBuilder

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

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentOutOfRangeException

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

OutOfMemoryException

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

UInt16.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per liberare 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'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

• UInt16

Insert(Int32, String)

Origine:

StringBuilder.cs

Inserisce una stringa in questa istanza in corrispondenza della posizione del carattere specificata.

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

Parametri

index

Int32

Posizione in questa istanza in cui inizia l'inserimento.

value

String

Stringa da inserire.

Restituisce

StringBuilder

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

Eccezioni

ArgumentOutOfRangeException

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

oppure

La lunghezza corrente di questo StringBuilder oggetto più la lunghezza di value supera MaxCapacity.

Commenti

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

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

Vedi anche

• String

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

Origine:

StringBuilder.cs

Inserisce la rappresentazione di stringa di una sottoarray specificata di caratteri Unicode in questa istanza in corrispondenza della 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);

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 valuedi .

charCount

Int32

Numero di caratteri da inserire.

Restituisce

StringBuilder

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

Eccezioni

ArgumentNullException

value è nulle startIndex e charCount non sono zero.

ArgumentOutOfRangeException

index, startIndexo charCount è minore di zero.

oppure

index è maggiore della lunghezza di questa istanza.

oppure

startIndex plus charCount non è una posizione all'interno valuedi .

oppure

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

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

Insert(Int32, Single)

Origine:

StringBuilder.cs

Inserisce la rappresentazione di stringa di un numero a virgola mobile a precisione singola in questa istanza in corrispondenza della 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

StringBuilder

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

Eccezioni

ArgumentOutOfRangeException

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

OutOfMemoryException

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

Single.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per liberare 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'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

• Single

Insert(Int32, SByte)

Origine:

StringBuilder.cs

Importante

Questa API non è conforme a CLS.

Inserisce la rappresentazione di stringa di un intero con segno a 8 bit specificato in questa istanza in corrispondenza della 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

StringBuilder

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

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentOutOfRangeException

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

OutOfMemoryException

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

SByte.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per liberare 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'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

• SByte

Insert(Int32, ReadOnlySpan<Char>)

Origine:

StringBuilder.cs

Inserisce la sequenza di caratteri in questa istanza in corrispondenza della 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

StringBuilder

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

Commenti

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

Insert(Int32, Int16)

Origine:

StringBuilder.cs

Inserisce la rappresentazione di stringa di un intero con segno a 16 bit specificato in questa istanza in corrispondenza della 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

StringBuilder

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

Eccezioni

ArgumentOutOfRangeException

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

OutOfMemoryException

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

Int16.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per liberare 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'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

• Int16

Insert(Int32, Int64)

Origine:

StringBuilder.cs

Inserisce la rappresentazione di stringa di un intero con segno a 64 bit in questa istanza in corrispondenza della 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

StringBuilder

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

Eccezioni

ArgumentOutOfRangeException

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

OutOfMemoryException

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

Int64.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per liberare 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'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

• Int64

Insert(Int32, Int32)

Origine:

StringBuilder.cs

Inserisce la rappresentazione di stringa di un intero con segno a 32 bit specificato in questa istanza in corrispondenza della 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

StringBuilder

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

Eccezioni

ArgumentOutOfRangeException

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

OutOfMemoryException

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

Int32.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per liberare 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'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

• Int32

Insert(Int32, Double)

Origine:

StringBuilder.cs

Inserisce la rappresentazione di stringa di un numero a virgola mobile e precisione doppia in questa istanza in corrispondenza della 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

StringBuilder

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

Eccezioni

ArgumentOutOfRangeException

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

OutOfMemoryException

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

Double.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per liberare 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'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

• Double

Insert(Int32, Decimal)

Origine:

StringBuilder.cs

Inserisce la rappresentazione di stringa di un numero decimale in questa istanza in corrispondenza della 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

StringBuilder

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

Eccezioni

ArgumentOutOfRangeException

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

OutOfMemoryException

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

Decimal.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per liberare 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'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

• Decimal

Insert(Int32, Char[])

Origine:

StringBuilder.cs

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

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

Parametri

index

Int32

Posizione in questa istanza in cui inizia l'inserimento.

value

Char[]

Matrice di caratteri da inserire.

Restituisce

StringBuilder

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

Eccezioni

ArgumentOutOfRangeException

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

oppure

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

I caratteri esistenti vengono spostati per liberare 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.

Insert(Int32, Char)

Origine:

StringBuilder.cs

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

StringBuilder

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

Eccezioni

ArgumentOutOfRangeException

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

oppure

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

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

Vedi anche

• Char

Insert(Int32, Byte)

Origine:

StringBuilder.cs

Inserisce la rappresentazione di stringa di un intero senza segno a 8 bit specificato in questa istanza in corrispondenza della 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

StringBuilder

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

Eccezioni

ArgumentOutOfRangeException

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

OutOfMemoryException

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

Byte.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per liberare 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'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

• Byte

Insert(Int32, Boolean)

Origine:

StringBuilder.cs

Inserisce la rappresentazione di stringa di un valore booleano in questa istanza in corrispondenza della 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

StringBuilder

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

Eccezioni

ArgumentOutOfRangeException

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

OutOfMemoryException

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

Boolean.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per liberare 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'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

• Boolean

Insert(Int32, Object)

Origine:

StringBuilder.cs

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

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

Parametri

index

Int32

Posizione in questa istanza in cui inizia l'inserimento.

value

Object

Oggetto da inserire o null.

Restituisce

StringBuilder

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

Eccezioni

ArgumentOutOfRangeException

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

OutOfMemoryException

L'estensione del valore di questa istanza supererebbe MaxCapacity.

Commenti

Object.ToString viene usato per ottenere una rappresentazione di stringa di value. I caratteri esistenti vengono spostati per liberare 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'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

• Object