StringBuilder.Insert Methode

Definition

Namespace:: System.Text

Assemblys:: mscorlib.dll, System.Runtime.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Überlädt

Name	Beschreibung
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 dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, UInt32)	Fügt die Zeichenfolgendarstellung einer 32-Bit-Ganzzahl ohne Vorzeichen an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, UInt16)	Fügt die Zeichenfolgendarstellung einer 16-Bit-Ganzzahl ohne Vorzeichen an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, Rune)
Insert(Int32, String)	Fügt an der angegebenen Zeichenposition eine Zeichenfolge in diese Instanz ein.
Insert(Int32, Char[], Int32, Int32)	Fügt die Zeichenfolgendarstellung eines angegebenen Unterarrays von Unicode-Zeichen an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, Single)	Fügt die Zeichenfolgendarstellung einer Gleitkommazahl mit einfacher Genauigkeit an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, SByte)	Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-ganzzahligen Vorzeichen an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, ReadOnlySpan<Char>)	Fügt die Abfolge von Zeichen an der angegebenen Zeichenposition in diese Instanz ein.
Insert(Int32, Int16)	Fügt die Zeichenfolgendarstellung einer angegebenen 16-Bit-ganzzahligen Vorzeichen an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, Int64)	Fügt die Zeichenfolgendarstellung einer 64-Bit-ganzzahligen Vorzeichen an dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, Int32)	Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-Ganzzahl in diese Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, Double)	Fügt die Zeichenfolgendarstellung einer Gleitkommazahl mit doppelter Genauigkeit an dieser Instanz an der angegebenen Zeichenposition 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 Unicode-Zeichenarrays 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 dieser Instanz an der angegebenen Zeichenposition ein.
Insert(Int32, Boolean)	Fügt die Zeichenfolgendarstellung eines booleschen Werts 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.

Beispiele

Im folgenden Beispiel wird die Insert Methode veranschaulicht.

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)

Quelle:: StringBuilder.cs

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 einzufügenden valueMale.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz nach Abschluss der Einfügung.

Ausnahmen

ArgumentOutOfRangeException

index ist kleiner als Null oder größer als die aktuelle Länge dieser Instanz.

-oder-

count ist kleiner als 0.

OutOfMemoryException

Die aktuelle Länge dieses StringBuilder Objekts plus die Zeitdauer valuecount überschreitet MaxCapacity.

Hinweise

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

Dieses StringBuilder Objekt wird nicht geändert, wenn value dies nicht null der Fall istnull, value aber seine Länge null ist oder count null ist.

Weitere Informationen

String

Gilt für:

Insert(Int32, UInt64)

Quelle:: StringBuilder.cs

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 dieser Instanz an der angegebenen Zeichenposition 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

StringBuilder

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

Attribute: CLSCompliantAttribute

Ausnahmen

ArgumentOutOfRangeException

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

OutOfMemoryException

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

UInt64.ToString wird verwendet, um eine Zeichenfolgendarstellung von value. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieser Instanz wird nach Bedarf angepasst.

Hinweise für Aufrufer

In .NET Framework 3.5 Service Pack 1 und früheren Versionen haben Aufrufe dieser Methode eine ArgumentOutOfRangeExceptionvalue Überschreitung der Gesamtlänge MaxCapacitydes Objekts verursacht. Ab .NET Framework 4 löst die Methode eine OutOfMemoryException.

Weitere Informationen

UInt64

Gilt für:

Insert(Int32, UInt32)

Quelle:: StringBuilder.cs

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 dieser Instanz an der angegebenen Zeichenposition 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

StringBuilder

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

Attribute: CLSCompliantAttribute

Ausnahmen

ArgumentOutOfRangeException

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

OutOfMemoryException

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

UInt32.ToString wird verwendet, um eine Zeichenfolgendarstellung von value. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieser Instanz wird nach Bedarf angepasst.

Hinweise für Aufrufer

Weitere Informationen

UInt32

Gilt für:

Insert(Int32, UInt16)

Quelle:: StringBuilder.cs

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 dieser Instanz an der angegebenen Zeichenposition 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

StringBuilder

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

Attribute: CLSCompliantAttribute

Ausnahmen

ArgumentOutOfRangeException

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

OutOfMemoryException

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

UInt16.ToString wird verwendet, um eine Zeichenfolgendarstellung von value. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieser Instanz wird nach Bedarf angepasst.

Hinweise für Aufrufer

Weitere Informationen

UInt16

Gilt für:

Insert(Int32, Rune)

public:
 System::Text::StringBuilder ^ Insert(int index, System::Text::Rune value);

public System.Text.StringBuilder Insert(int index, System.Text.Rune value);

member this.Insert : int * System.Text.Rune -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Rune) As StringBuilder

Parameter

index: Int32

value: Rune

Gibt zurück

StringBuilder

Gilt für:

Insert(Int32, String)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Fügt an der angegebenen Zeichenposition eine Zeichenfolge 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

StringBuilder

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

Ausnahmen

ArgumentOutOfRangeException

index ist kleiner als Null oder größer als die aktuelle Länge dieser Instanz.

-oder-

Die aktuelle Länge dieses StringBuilder Objekts plus die Länge der value Überschreitungen MaxCapacity.

Hinweise

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

Diese Instanz von StringBuilder wird nicht geändert, value wenn value oder nullnichtnull, aber die Länge null ist.

Weitere Informationen

String

Gilt für:

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

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Fügt die Zeichenfolgendarstellung eines angegebenen Unterarrays von Unicode-Zeichen an dieser Instanz an der angegebenen Zeichenposition 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 Anfangsindex innerhalb valuevon .

charCount: Int32

Die Anzahl der einzufügenden Zeichen.

Gibt zurück

StringBuilder

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

Ausnahmen

ArgumentNullException

value ist null, und startIndexcharCount sind nicht Null.

ArgumentOutOfRangeException

index, startIndexoder charCount ist kleiner als Null.

-oder-

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

-oder-

startIndex plus charCount ist keine Position innerhalb value.

-oder-

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

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

Gilt für:

Insert(Int32, Single)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer Gleitkommazahl mit einfacher Genauigkeit an dieser Instanz an der angegebenen Zeichenposition 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

StringBuilder

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

Ausnahmen

ArgumentOutOfRangeException

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

OutOfMemoryException

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

Single.ToString wird verwendet, um eine Zeichenfolgendarstellung von value. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieser Instanz wird nach Bedarf angepasst.

Hinweise für Aufrufer

Weitere Informationen

Single

Gilt für:

Insert(Int32, SByte)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-ganzzahligen Vorzeichen an dieser Instanz an der angegebenen Zeichenposition 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

StringBuilder

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

Attribute: CLSCompliantAttribute

Ausnahmen

ArgumentOutOfRangeException

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

OutOfMemoryException

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

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

Hinweise für Aufrufer

Weitere Informationen

SByte

Gilt für:

Insert(Int32, ReadOnlySpan<Char>)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Fügt die Abfolge 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>

Der einzufügende Zeichenbereich.

Gibt zurück

StringBuilder

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

Hinweise

Die vorhandenen Zeichen werden verschoben, um Platz für die Zeichensequenz im value einzufügen. Die Kapazität wird nach Bedarf angepasst.

Gilt für:

Insert(Int32, Int16)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer angegebenen 16-Bit-ganzzahligen Vorzeichen an dieser Instanz an der angegebenen Zeichenposition 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

StringBuilder

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

Ausnahmen

ArgumentOutOfRangeException

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

OutOfMemoryException

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

Int16.ToString wird verwendet, um eine Zeichenfolgendarstellung von value. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieser Instanz wird nach Bedarf angepasst.

Hinweise für Aufrufer

Weitere Informationen

Int16

Gilt für:

Insert(Int32, Int64)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer 64-Bit-ganzzahligen Vorzeichen an dieser Instanz an der angegebenen Zeichenposition 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

StringBuilder

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

Ausnahmen

ArgumentOutOfRangeException

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

OutOfMemoryException

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

Int64.ToString wird verwendet, um eine Zeichenfolgendarstellung von value. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieser Instanz wird nach Bedarf angepasst.

Hinweise für Aufrufer

Weitere Informationen

Int64

Gilt für:

Insert(Int32, Int32)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer angegebenen 32-Bit-Ganzzahl in diese Instanz an der angegebenen Zeichenposition 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

StringBuilder

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

Ausnahmen

ArgumentOutOfRangeException

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

OutOfMemoryException

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

Int32.ToString wird verwendet, um eine Zeichenfolgendarstellung von value. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieser Instanz wird nach Bedarf angepasst.

Hinweise für Aufrufer

Weitere Informationen

Int32

Gilt für:

Insert(Int32, Double)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer Gleitkommazahl mit doppelter Genauigkeit an dieser Instanz an der angegebenen Zeichenposition 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

StringBuilder

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

Ausnahmen

ArgumentOutOfRangeException

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

OutOfMemoryException

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

Double.ToString wird verwendet, um eine Zeichenfolgendarstellung von value. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieser Instanz wird nach Bedarf angepasst.

Hinweise für Aufrufer

Weitere Informationen

Double

Gilt für:

Insert(Int32, Decimal)

Quelle:: StringBuilder.cs

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

StringBuilder

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

Ausnahmen

ArgumentOutOfRangeException

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

OutOfMemoryException

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

Decimal.ToString wird verwendet, um eine Zeichenfolgendarstellung von value. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieser Instanz wird nach Bedarf angepasst.

Hinweise für Aufrufer

Weitere Informationen

Decimal

Gilt für:

Insert(Int32, Char[])

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Fügt die Zeichenfolgendarstellung eines angegebenen Unicode-Zeichenarrays 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

StringBuilder

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

Ausnahmen

ArgumentOutOfRangeException

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

-oder-

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

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

Wenn value ja null, wird dies StringBuilder nicht geändert.

Gilt für:

Insert(Int32, Char)

Quelle:: StringBuilder.cs

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

StringBuilder

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

Ausnahmen

ArgumentOutOfRangeException

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

-oder-

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

Char.ToString wird verwendet, um eine Zeichenfolgendarstellung von value. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieser Instanz wird nach Bedarf angepasst.

Weitere Informationen

Char

Gilt für:

Insert(Int32, Byte)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Fügt die Zeichenfolgendarstellung einer angegebenen 8-Bit-ganzzahl ohne Vorzeichen an dieser Instanz an der angegebenen Zeichenposition 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

StringBuilder

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

Ausnahmen

ArgumentOutOfRangeException

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

OutOfMemoryException

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

Byte.ToString wird verwendet, um eine Zeichenfolgendarstellung von value. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieser Instanz wird nach Bedarf angepasst.

Hinweise für Aufrufer

Weitere Informationen

Byte

Gilt für:

Insert(Int32, Boolean)

Quelle:: StringBuilder.cs

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

StringBuilder

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

Ausnahmen

ArgumentOutOfRangeException

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

OutOfMemoryException

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

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

Hinweise für Aufrufer

Weitere Informationen

Boolean

Gilt für:

Insert(Int32, Object)

Quelle:: StringBuilder.cs

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

StringBuilder

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

Ausnahmen

ArgumentOutOfRangeException

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

OutOfMemoryException

Durch das Vergrößern des Werts dieser Instanz würde der Wert überschritten MaxCapacity.

Hinweise

Object.ToString wird verwendet, um eine Zeichenfolgendarstellung von value. Vorhandene Zeichen werden verschoben, um Platz für den neuen Text zu schaffen. Die Kapazität dieser Instanz wird nach Bedarf angepasst.

Ist value dies der Fall, ist nullder Wert dieser Instanz unverändert.

Hinweise für Aufrufer

Weitere Informationen

Object

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

StringBuilder.Insert Methode

Definition

Überlädt

Beispiele

Insert(Int32, String, Int32)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Insert(Int32, UInt64)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

Insert(Int32, UInt32)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

Insert(Int32, UInt16)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

Insert(Int32, Rune)

Parameter

Gibt zurück

Gilt für:

Insert(Int32, String)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

Insert(Int32, Single)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

Insert(Int32, SByte)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

Insert(Int32, ReadOnlySpan<Char>)

Parameter

Gibt zurück

Hinweise

Gilt für:

Insert(Int32, Int16)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Hinweise für Aufrufer