Teilen über


StringBuilder.Insert Methode

Definition

Fügt die Zeichenfolgendarstellung eines angegebenen Objekts an einer angegebenen Zeichenposition in diese Instanz ein.

Überlädt

Insert(Int32, SByte)

Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-Ganzzahl mit Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

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

Fügt die Zeichenfolgendarstellung eines angegebenen Unterarrays von Unicode-Zeichen an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, String, Int32)

Fügt eine oder mehrere Kopien einer angegebenen Zeichenfolge an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, UInt64)

Fügt die Zeichenfolgendarstellung einer 64-Bit-Ganzzahl ohne Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, UInt32)

Fügt die Zeichenfolgendarstellung einer 32-Bit-Ganzzahl ohne Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, UInt16)

Fügt die Zeichenfolgendarstellung einer 16-Bit-Ganzzahl ohne Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, String)

Fügt eine Zeichenfolge an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, Single)

Fügt die Zeichenfolgendarstellung einer Gleitkommazahl mit einfacher Genauigkeit an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, ReadOnlySpan<Char>)

Fügt die Sequenz von Zeichen an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, Int16)

Fügt die Zeichenfolgendarstellung einer angegebenen 16-Bit-Ganzzahl mit Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, Int64)

Fügt die Zeichenfolgendarstellung einer 64-Bit-Ganzzahl mit Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, Int32)

Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-Ganzzahl mit Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, Object)

Fügt die Zeichenfolgendarstellung eines Objekts an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, Double)

Fügt die Zeichenfolgendarstellung einer Gleitkommazahl mit doppelter Genauigkeit an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, Decimal)

Fügt die Zeichenfolgendarstellung einer Dezimalzahl an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, Char[])

Fügt die Zeichenfolgendarstellung eines angegebenen Arrays von Unicode-Zeichen an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, Char)

Fügt die Zeichenfolgendarstellung eines angegebenen Unicode-Zeichens an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, Byte)

Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-Ganzzahl ohne Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

Insert(Int32, Boolean)

Fügt die Zeichenfolgendarstellung eines booleschen Werts an der angegebenen Zeichenposition in diese Instanz ein.

Beispiele

Das folgende Beispiel veranschaulicht die Insert Methode.

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)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-Ganzzahl mit Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
SByte

Der einzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Attribute

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

SByte.ToString wird verwendet, um eine Zeichenfolgendarstellung von valueabzurufen. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität wird bei Bedarf angepasst.

Hinweise für Aufrufer

In der .NET Framework 3.5 Service Pack 1 und früheren Versionen wurde durch Aufrufe dieser Methode ein ArgumentOutOfRangeException ausgelöst, wenn das Einfügen value dazu führen würde, dass die Gesamtlänge des Objekts überschritten MaxCapacitywird. Ab dem .NET Framework 4 löst die -Methode einen ausOutOfMemoryException.

Weitere Informationen

Gilt für:

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

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung eines angegebenen Unterarrays von Unicode-Zeichen an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
Char[]

Ein Zeichenarray.

startIndex
Int32

Der Startindex in value.

charCount
Int32

Die Anzahl der einzufügenden Zeichen.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Ausnahmen

value ist null, und startIndex und charCount sind nicht 0 (null).

index, startIndex oder charCount ist kleiner als 0 (null).

- oder -

index ist größer als die Länge dieser Instanz.

- oder -

startIndex plus charCount ist keine Position in value.

- oder -

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Gilt für:

Insert(Int32, String, Int32)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt eine oder mehrere Kopien einer angegebenen Zeichenfolge an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
String

Die einzufügende Zeichenfolge.

count
Int32

Die Anzahl der Einfügewiederholungen für value.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Ausnahmen

index ist kleiner als 0 (null) oder größer als die aktuelle Länge dieser Instanz.

- oder -

count ist kleiner als Null.

Die aktuelle Länge dieses StringBuilder-Objekts plus die Länge von value multipliziert mit count überschreitet MaxCapacity.

Hinweise

Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Dieses StringBuilder Objekt wird nicht geändert, wenn nullvalue , ist nichtnull, value aber seine Länge ist 0 oder count null.

Weitere Informationen

Gilt für:

Insert(Int32, UInt64)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Fügt die Zeichenfolgendarstellung einer 64-Bit-Ganzzahl ohne Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
UInt64

Der einzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Attribute

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

UInt64.ToString wird verwendet, um eine Zeichenfolgendarstellung von valueabzurufen. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

In der .NET Framework 3.5 Service Pack 1 und früheren Versionen wurde durch Aufrufe dieser Methode ein ArgumentOutOfRangeException ausgelöst, wenn das Einfügen value dazu führen würde, dass die Gesamtlänge des Objekts überschritten MaxCapacitywird. Ab dem .NET Framework 4 löst die -Methode einen ausOutOfMemoryException.

Weitere Informationen

Gilt für:

Insert(Int32, UInt32)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Fügt die Zeichenfolgendarstellung einer 32-Bit-Ganzzahl ohne Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
UInt32

Der einzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Attribute

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

UInt32.ToString wird verwendet, um eine Zeichenfolgendarstellung von valueabzurufen. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

In der .NET Framework 3.5 Service Pack 1 und früheren Versionen wurde durch Aufrufe dieser Methode ein ArgumentOutOfRangeException ausgelöst, wenn das Einfügen value dazu führen würde, dass die Gesamtlänge des Objekts überschritten MaxCapacitywird. Ab dem .NET Framework 4 löst die -Methode einen ausOutOfMemoryException.

Weitere Informationen

Gilt für:

Insert(Int32, UInt16)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Fügt die Zeichenfolgendarstellung einer 16-Bit-Ganzzahl ohne Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
UInt16

Der einzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Attribute

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

UInt16.ToString wird verwendet, um eine Zeichenfolgendarstellung von valueabzurufen. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

In der .NET Framework 3.5 Service Pack 1 und früheren Versionen wurde durch Aufrufe dieser Methode ein ArgumentOutOfRangeException ausgelöst, wenn das Einfügen value dazu führen würde, dass die Gesamtlänge des Objekts überschritten MaxCapacitywird. Ab dem .NET Framework 4 löst die -Methode einen ausOutOfMemoryException.

Weitere Informationen

Gilt für:

Insert(Int32, String)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt eine Zeichenfolge an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
String

Die einzufügende Zeichenfolge.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Ausnahmen

index ist kleiner als 0 (null) oder größer als die aktuelle Länge dieser Instanz.

- oder -

Die aktuelle Länge dieses StringBuilder-Objekts plus die Länge von value überschreiten MaxCapacity.

Hinweise

Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität wird bei Bedarf angepasst.

Dieser instance von StringBuilder wird nicht geändert, wenn valuenull, oder value nichtnull, aber seine Länge ist 0.

Weitere Informationen

Gilt für:

Insert(Int32, Single)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer Gleitkommazahl mit einfacher Genauigkeit an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
Single

Der einzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Single.ToString wird verwendet, um eine Zeichenfolgendarstellung von valueabzurufen. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

In der .NET Framework 3.5 Service Pack 1 und früheren Versionen wurde durch Aufrufe dieser Methode ein ArgumentOutOfRangeException ausgelöst, wenn das Einfügen value dazu führen würde, dass die Gesamtlänge des Objekts überschritten MaxCapacitywird. Ab dem .NET Framework 4 löst die -Methode einen ausOutOfMemoryException.

Weitere Informationen

Gilt für:

Insert(Int32, ReadOnlySpan<Char>)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Sequenz von Zeichen an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
ReadOnlySpan<Char>

Die einzufügende Zeichenspanne.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Hinweise

Die vorhandenen Zeichen werden verschoben, um Platz für die Zeichenfolge in der zu schaffen, value um sie einzufügen. Die Kapazität wird bei Bedarf angepasst.

Gilt für:

Insert(Int32, Int16)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer angegebenen 16-Bit-Ganzzahl mit Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
Int16

Der einzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Int16.ToString wird verwendet, um eine Zeichenfolgendarstellung von valueabzurufen. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

In der .NET Framework 3.5 Service Pack 1 und früheren Versionen wurde durch Aufrufe dieser Methode ein ArgumentOutOfRangeException ausgelöst, wenn das Einfügen value dazu führen würde, dass die Gesamtlänge des Objekts überschritten MaxCapacitywird. Ab dem .NET Framework 4 löst die -Methode einen ausOutOfMemoryException.

Weitere Informationen

Gilt für:

Insert(Int32, Int64)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer 64-Bit-Ganzzahl mit Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
Int64

Der einzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Int64.ToString wird verwendet, um eine Zeichenfolgendarstellung von valueabzurufen. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

In der .NET Framework 3.5 Service Pack 1 und früheren Versionen wurde durch Aufrufe dieser Methode ein ArgumentOutOfRangeException ausgelöst, wenn das Einfügen value dazu führen würde, dass die Gesamtlänge des Objekts überschritten MaxCapacitywird. Ab dem .NET Framework 4 löst die -Methode einen ausOutOfMemoryException.

Weitere Informationen

Gilt für:

Insert(Int32, Int32)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-Ganzzahl mit Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
Int32

Der einzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Int32.ToString wird verwendet, um eine Zeichenfolgendarstellung von valueabzurufen. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

In der .NET Framework 3.5 Service Pack 1 und früheren Versionen wurde durch Aufrufe dieser Methode ein ArgumentOutOfRangeException ausgelöst, wenn das Einfügen value dazu führen würde, dass die Gesamtlänge des Objekts überschritten MaxCapacitywird. Ab dem .NET Framework 4 löst die -Methode einen ausOutOfMemoryException.

Weitere Informationen

Gilt für:

Insert(Int32, Object)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung eines Objekts an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
Object

Das einzufügende Objekt oder null.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Object.ToString wird verwendet, um eine Zeichenfolgendarstellung von valueabzurufen. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Wenn value istnull, ist der Wert dieser instance unverändert.

Hinweise für Aufrufer

In der .NET Framework 3.5 Service Pack 1 und früheren Versionen wurde durch Aufrufe dieser Methode ein ArgumentOutOfRangeException ausgelöst, wenn das Einfügen value dazu führen würde, dass die Gesamtlänge des Objekts überschritten MaxCapacitywird. Ab dem .NET Framework 4 löst die -Methode einen ausOutOfMemoryException.

Weitere Informationen

Gilt für:

Insert(Int32, Double)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer Gleitkommazahl mit doppelter Genauigkeit an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
Double

Der einzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Double.ToString wird verwendet, um eine Zeichenfolgendarstellung von valueabzurufen. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

In der .NET Framework 3.5 Service Pack 1 und früheren Versionen wurde durch Aufrufe dieser Methode ein ArgumentOutOfRangeException ausgelöst, wenn das Einfügen value dazu führen würde, dass die Gesamtlänge des Objekts überschritten MaxCapacitywird. Ab dem .NET Framework 4 löst die -Methode einen ausOutOfMemoryException.

Weitere Informationen

Gilt für:

Insert(Int32, Decimal)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer Dezimalzahl an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
Decimal

Der einzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Decimal.ToString wird verwendet, um eine Zeichenfolgendarstellung von valueabzurufen. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

In der .NET Framework 3.5 Service Pack 1 und früheren Versionen wurde durch Aufrufe dieser Methode ein ArgumentOutOfRangeException ausgelöst, wenn das Einfügen value dazu führen würde, dass die Gesamtlänge des Objekts überschritten MaxCapacitywird. Ab dem .NET Framework 4 löst die -Methode einen ausOutOfMemoryException.

Weitere Informationen

Gilt für:

Insert(Int32, Char[])

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung eines angegebenen Arrays von Unicode-Zeichen an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
Char[]

Das einzufügende Zeichenarray.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

- oder -

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Wenn value ist null, wird der StringBuilder nicht geändert.

Gilt für:

Insert(Int32, Char)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung eines angegebenen Unicode-Zeichens an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
Char

Der einzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

- oder -

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Char.ToString wird verwendet, um eine Zeichenfolgendarstellung von valueabzurufen. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Weitere Informationen

Gilt für:

Insert(Int32, Byte)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-Ganzzahl ohne Vorzeichen an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
Byte

Der einzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Byte.ToString wird verwendet, um eine Zeichenfolgendarstellung von valueabzurufen. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieses instance wird bei Bedarf angepasst.

Hinweise für Aufrufer

In der .NET Framework 3.5 Service Pack 1 und früheren Versionen wurde durch Aufrufe dieser Methode ein ArgumentOutOfRangeException ausgelöst, wenn das Einfügen value dazu führen würde, dass die Gesamtlänge des Objekts überschritten MaxCapacitywird. Ab dem .NET Framework 4 löst die -Methode einen ausOutOfMemoryException.

Weitere Informationen

Gilt für:

Insert(Int32, Boolean)

Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs
Quelle:
StringBuilder.cs

Fügt die Zeichenfolgendarstellung eines booleschen Werts an der angegebenen Zeichenposition in diese Instanz ein.

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

Parameter

index
Int32

Die Position in dieser Instanz, an der die Einfügung beginnt.

value
Boolean

Der einzufügende Wert.

Gibt zurück

Ein Verweis auf diese Instanz, nachdem der Einfügevorgang abgeschlossen wurde.

Ausnahmen

index ist kleiner als 0 (null) oder größer als die Länge dieser Instanz.

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Boolean.ToString wird verwendet, um eine Zeichenfolgendarstellung von valueabzurufen. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität wird bei Bedarf angepasst.

Hinweise für Aufrufer

In der .NET Framework 3.5 Service Pack 1 und früheren Versionen wurde durch Aufrufe dieser Methode ein ArgumentOutOfRangeException ausgelöst, wenn das Einfügen value dazu führen würde, dass die Gesamtlänge des Objekts überschritten MaxCapacitywird. Ab dem .NET Framework 4 löst die -Methode einen ausOutOfMemoryException.

Weitere Informationen

Gilt für: