Sdílet prostřednictvím


StringBuilder.Insert Metoda

Definice

Vloží řetězcovou reprezentaci zadaného objektu do této instance na pozici zadaného znaku.

Přetížení

Insert(Int32, SByte)

Vloží řetězcovou reprezentaci zadaného 8bitového celého čísla se znaménkem do této instance na zadané pozici znaku.

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

Vloží řetězcovou reprezentaci zadaného dílčího pole znaků Unicode do této instance na pozici zadaného znaku.

Insert(Int32, String, Int32)

Vloží jednu nebo více kopií zadaného řetězce do této instance na pozici zadaného znaku.

Insert(Int32, UInt64)

Vloží řetězcovou reprezentaci 64bitového celého čísla bez znaménka do této instance na zadané pozici znaku.

Insert(Int32, UInt32)

Vloží řetězcovou reprezentaci 32bitového celého čísla bez znaménka do této instance na zadané pozici znaku.

Insert(Int32, UInt16)

Vloží řetězcovou reprezentaci 16bitového celého čísla bez znaménka do této instance na zadané pozici znaku.

Insert(Int32, String)

Vloží řetězec do této instance na zadané pozici znaku.

Insert(Int32, Single)

Vloží řetězcovou reprezentaci čísla s plovoucí desetinnou čárkou s jednou přesností do této instance na pozici zadaného znaku.

Insert(Int32, ReadOnlySpan<Char>)

Vloží posloupnost znaků do této instance na zadané pozici znaku.

Insert(Int32, Int16)

Vloží řetězcovou reprezentaci zadaného 16bitového celého čísla se znaménkem do této instance na zadané pozici znaku.

Insert(Int32, Int64)

Vloží řetězcovou reprezentaci 64bitového celého čísla se znaménkem do této instance na pozici zadaného znaku.

Insert(Int32, Int32)

Vloží řetězcovou reprezentaci zadaného 32bitového celého čísla se znaménkem do této instance na zadané pozici znaku.

Insert(Int32, Object)

Vloží řetězcovou reprezentaci objektu do této instance na pozici zadaného znaku.

Insert(Int32, Double)

Vloží řetězcovou reprezentaci čísla s plovoucí desetinnou čárkou s dvojitou přesností do této instance na pozici zadaného znaku.

Insert(Int32, Decimal)

Vloží řetězcovou reprezentaci desetinného čísla do této instance na pozici zadaného znaku.

Insert(Int32, Char[])

Vloží řetězcovou reprezentaci zadaného pole znaků Unicode do této instance na pozici zadaného znaku.

Insert(Int32, Char)

Vloží řetězcovou reprezentaci zadaného znaku Unicode do této instance na pozici zadaného znaku.

Insert(Int32, Byte)

Vloží řetězcovou reprezentaci zadaného 8bitového celého čísla bez znaménka do této instance na pozici zadaného znaku.

Insert(Int32, Boolean)

Vloží řetězcovou reprezentaci logické hodnoty do této instance na pozici zadaného znaku.

Příklady

Následující příklad ukazuje metodu Insert .

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)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Vloží řetězcovou reprezentaci zadaného 8bitového celého čísla se znaménkem do této instance na zadané pozici znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
SByte

Hodnota, která se má vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Atributy

Výjimky

index je menší než nula nebo větší než délka této instance.

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

SByte.ToString slouží k získání řetězcové reprezentace value. Stávající znaky se posunou, aby uvolnily místo pro nový text. Kapacita se upraví podle potřeby.

Poznámky pro volající

V rozhraní .NET Framework 3.5 Service Pack 1 a starších verzích volání této metody vyvolá ArgumentOutOfRangeException , pokud vložení value způsobí, že celková délka objektu překročí MaxCapacity. Počínaje rozhraním .NET Framework 4 vyvolá metoda .OutOfMemoryException

Viz také

Platí pro

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

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží řetězcovou reprezentaci zadaného dílčího pole znaků Unicode do této instance na pozici zadaného znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
Char[]

Pole znaků.

startIndex
Int32

Počáteční index v rámci value.

charCount
Int32

Počet znaků, které se mají vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Výjimky

value je null, a startIndex a charCount nejsou nula.

index, startIndexnebo charCount je menší než nula.

-nebo-

index je větší než délka této instance.

-nebo-

startIndex plus charCount není pozice v rámci value.

-nebo-

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Stávající znaky se posunou, aby uvolnily místo pro nový text. Kapacita této instance se upraví podle potřeby.

Platí pro

Insert(Int32, String, Int32)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží jednu nebo více kopií zadaného řetězce do této instance na pozici zadaného znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
String

Řetězec, který chcete vložit.

count
Int32

Kolikrát se má vložit value.

Návraty

Odkaz na tuto instanci po vložení byla dokončena.

Výjimky

index je menší než nula nebo větší než aktuální délka této instance.

-nebo-

Hodnota count je menší než nula.

Aktuální délka tohoto StringBuilder objektu plus délka value časů countMaxCapacitypřekračuje .

Poznámky

Stávající znaky se posunou, aby uvolnily místo pro nový text. Kapacita této instance se upraví podle potřeby.

Tento StringBuilder objekt se nezmění, pokud value je null, value ale null jeho délka je nula, nebo count je nula.

Viz také

Platí pro

Insert(Int32, UInt64)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Vloží řetězcovou reprezentaci 64bitového celého čísla bez znaménka do této instance na zadané pozici znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
UInt64

Hodnota, která se má vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Atributy

Výjimky

index je menší než nula nebo větší než délka této instance.

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

UInt64.ToString slouží k získání řetězcové reprezentace value. Stávající znaky se posunou, aby uvolnily místo pro nový text. Kapacita této instance se upraví podle potřeby.

Poznámky pro volající

V rozhraní .NET Framework 3.5 Service Pack 1 a starších verzích volání této metody vyvolá ArgumentOutOfRangeException , pokud vložení value způsobí, že celková délka objektu překročí MaxCapacity. Počínaje rozhraním .NET Framework 4 vyvolá metoda .OutOfMemoryException

Viz také

Platí pro

Insert(Int32, UInt32)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Vloží řetězcovou reprezentaci 32bitového celého čísla bez znaménka do této instance na zadané pozici znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
UInt32

Hodnota, která se má vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Atributy

Výjimky

index je menší než nula nebo větší než délka této instance.

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

UInt32.ToStringslouží k získání řetězcové reprezentace .value Stávající znaky jsou posunuty, aby se uvolnilo místo pro nový text. Kapacita této instance se upraví podle potřeby.

Poznámky pro volající

V rozhraní .NET Framework 3.5 Service Pack 1 a starších verzích volání této metody vyvolá ArgumentOutOfRangeException , pokud vložení value způsobí, že celková délka objektu překročí MaxCapacity. Počínaje rozhraním .NET Framework 4 vyvolá metoda .OutOfMemoryException

Viz také

Platí pro

Insert(Int32, UInt16)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Vloží řetězcovou reprezentaci 16bitového celého čísla bez znaménka do této instance na zadané pozici znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
UInt16

Hodnota, která se má vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Atributy

Výjimky

index je menší než nula nebo větší než délka této instance.

Zvětšení hodnoty této instance by překročilo MaxCapacityhodnotu .

Poznámky

UInt16.ToStringslouží k získání řetězcové reprezentace .value Stávající znaky jsou posunuty, aby se uvolnilo místo pro nový text. Kapacita této instance se upraví podle potřeby.

Poznámky pro volající

V rozhraní .NET Framework 3.5 Service Pack 1 a starších verzích volání této metody vyvolalo ArgumentOutOfRangeException , pokud vložení value způsobí, že celková délka objektu překročí MaxCapacity. Počínaje rozhraním .NET Framework 4 metoda vyvolá .OutOfMemoryException

Viz také

Platí pro

Insert(Int32, String)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží řetězec do této instance na zadané pozici znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
String

Řetězec, který chcete vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Výjimky

index je menší než nula nebo větší než aktuální délka této instance.

-nebo-

Aktuální délka tohoto StringBuilder objektu plus délka objektu value překračuje MaxCapacity.

Poznámky

Stávající znaky jsou posunuty, aby se uvolnilo místo pro nový text. Kapacita je upravena podle potřeby.

Tato instance se StringBuilder nezmění, pokud value je nullnebo value není null , ale její délka je nula.

Viz také

Platí pro

Insert(Int32, Single)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží řetězcovou reprezentaci čísla s plovoucí desetinnou čárkou s jednou přesností do této instance na zadané pozici znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
Single

Hodnota, která se má vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Výjimky

index je menší než nula nebo větší než délka této instance.

Zvětšení hodnoty této instance by překročilo MaxCapacityhodnotu .

Poznámky

Single.ToStringslouží k získání řetězcové reprezentace .value Stávající znaky jsou posunuty, aby se uvolnilo místo pro nový text. Kapacita této instance se upraví podle potřeby.

Poznámky pro volající

V rozhraní .NET Framework 3.5 Service Pack 1 a starších verzích volání této metody vyvolalo ArgumentOutOfRangeException , pokud vložení value způsobí, že celková délka objektu překročí MaxCapacity. Počínaje rozhraním .NET Framework 4 metoda vyvolá .OutOfMemoryException

Viz také

Platí pro

Insert(Int32, ReadOnlySpan<Char>)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží posloupnost znaků do této instance na zadané pozici znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
ReadOnlySpan<Char>

Rozsah znaků, který se má vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Poznámky

Stávající znaky jsou posunuty, aby se uvolnilo místo pro sekvenci znaků, která value je vloží. Kapacita je upravena podle potřeby.

Platí pro

Insert(Int32, Int16)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží řetězcovou reprezentaci zadaného 16bitového celého čísla se znaménkem do této instance na zadané pozici znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
Int16

Hodnota, která se má vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Výjimky

index je menší než nula nebo větší než délka této instance.

Zvětšení hodnoty této instance by překročilo MaxCapacityhodnotu .

Poznámky

Int16.ToStringslouží k získání řetězcové reprezentace .value Stávající znaky jsou posunuty, aby se uvolnilo místo pro nový text. Kapacita této instance se upraví podle potřeby.

Poznámky pro volající

V rozhraní .NET Framework 3.5 Service Pack 1 a starších verzích volání této metody vyvolalo ArgumentOutOfRangeException , pokud vložení value způsobí, že celková délka objektu překročí MaxCapacity. Počínaje rozhraním .NET Framework 4 metoda vyvolá .OutOfMemoryException

Viz také

Platí pro

Insert(Int32, Int64)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží řetězcovou reprezentaci 64bitového celého čísla se znaménkem do této instance na zadané pozici znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
Int64

Hodnota, která se má vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Výjimky

index je menší než nula nebo větší než délka této instance.

Zvětšení hodnoty této instance by překročilo MaxCapacityhodnotu .

Poznámky

Int64.ToStringslouží k získání řetězcové reprezentace .value Stávající znaky jsou posunuty, aby se uvolnilo místo pro nový text. Kapacita této instance se upraví podle potřeby.

Poznámky pro volající

V rozhraní .NET Framework 3.5 Service Pack 1 a starších verzích volání této metody vyvolalo ArgumentOutOfRangeException , pokud vložení value způsobí, že celková délka objektu překročí MaxCapacity. Počínaje rozhraním .NET Framework 4 metoda vyvolá .OutOfMemoryException

Viz také

Platí pro

Insert(Int32, Int32)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží řetězcovou reprezentaci zadaného 32bitového celého čísla se znaménkem do této instance na zadané pozici znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
Int32

Hodnota, která se má vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Výjimky

index je menší než nula nebo větší než délka této instance.

Zvětšení hodnoty této instance by překročilo MaxCapacityhodnotu .

Poznámky

Int32.ToStringslouží k získání řetězcové reprezentace .value Stávající znaky jsou posunuty, aby se uvolnilo místo pro nový text. Kapacita této instance se upraví podle potřeby.

Poznámky pro volající

V rozhraní .NET Framework 3.5 Service Pack 1 a starších verzích volání této metody vyvolalo ArgumentOutOfRangeException , pokud vložení value způsobí, že celková délka objektu překročí MaxCapacity. Počínaje rozhraním .NET Framework 4 metoda vyvolá .OutOfMemoryException

Viz také

Platí pro

Insert(Int32, Object)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží řetězcovou reprezentaci objektu do této instance na zadané pozici znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
Object

Objekt, který se má vložit, nebo null.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Výjimky

index je menší než nula nebo větší než délka této instance.

Zvětšení hodnoty této instance by překročilo MaxCapacityhodnotu .

Poznámky

Object.ToStringslouží k získání řetězcové reprezentace .value Stávající znaky jsou posunuty, aby se uvolnilo místo pro nový text. Kapacita této instance se upraví podle potřeby.

Pokud value je null, hodnota této instance se nezmění.

Poznámky pro volající

V rozhraní .NET Framework 3.5 Service Pack 1 a starších verzích volání této metody vyvolalo ArgumentOutOfRangeException , pokud vložení value způsobí, že celková délka objektu překročí MaxCapacity. Počínaje rozhraním .NET Framework 4 metoda vyvolá .OutOfMemoryException

Viz také

Platí pro

Insert(Int32, Double)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží řetězcovou reprezentaci čísla s plovoucí desetinnou čárkou s dvojitou přesností do této instance v zadané pozici znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
Double

Hodnota, která se má vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Výjimky

index je menší než nula nebo větší než délka této instance.

Zvětšení hodnoty této instance by překročilo MaxCapacityhodnotu .

Poznámky

Double.ToStringslouží k získání řetězcové reprezentace .value Stávající znaky jsou posunuty, aby se uvolnilo místo pro nový text. Kapacita této instance se upraví podle potřeby.

Poznámky pro volající

V rozhraní .NET Framework 3.5 Service Pack 1 a starších verzích volání této metody vyvolalo ArgumentOutOfRangeException , pokud vložení value způsobí, že celková délka objektu překročí MaxCapacity. Počínaje rozhraním .NET Framework 4 metoda vyvolá .OutOfMemoryException

Viz také

Platí pro

Insert(Int32, Decimal)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží řetězcovou reprezentaci desetinného čísla do této instance na pozici zadaného znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
Decimal

Hodnota, která se má vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Výjimky

index je menší než nula nebo větší než délka této instance.

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Decimal.ToString slouží k získání řetězcové reprezentace value. Stávající znaky se posunou, aby uvolnily místo pro nový text. Kapacita této instance se upraví podle potřeby.

Poznámky pro volající

V rozhraní .NET Framework 3.5 Service Pack 1 a starších verzích volání této metody vyvolalo ArgumentOutOfRangeException , pokud vložení value způsobí, že celková délka objektu překročí MaxCapacity. Počínaje rozhraním .NET Framework 4 vyvolá metoda .OutOfMemoryException

Viz také

Platí pro

Insert(Int32, Char[])

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží řetězcovou reprezentaci zadaného pole znaků Unicode do této instance na pozici zadaného znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
Char[]

Pole znaků, které chcete vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Výjimky

index je menší než nula nebo větší než délka této instance.

-nebo-

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Stávající znaky se posunou, aby uvolnily místo pro nový text. Kapacita této instance se upraví podle potřeby.

Pokud value je null, nezmění se StringBuilder .

Platí pro

Insert(Int32, Char)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží řetězcovou reprezentaci zadaného znaku Unicode do této instance na pozici zadaného znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
Char

Hodnota, která se má vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Výjimky

index je menší než nula nebo větší než délka této instance.

-nebo-

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Char.ToString slouží k získání řetězcové reprezentace value. Stávající znaky se posunou, aby uvolnily místo pro nový text. Kapacita této instance se upraví podle potřeby.

Viz také

Platí pro

Insert(Int32, Byte)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží řetězcovou reprezentaci zadaného 8bitového celého čísla bez znaménka do této instance na pozici zadaného znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
Byte

Hodnota, která se má vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Výjimky

index je menší než nula nebo větší než délka této instance.

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Byte.ToString slouží k získání řetězcové reprezentace value. Stávající znaky se posunou, aby uvolnily místo pro nový text. Kapacita této instance se upraví podle potřeby.

Poznámky pro volající

V rozhraní .NET Framework 3.5 Service Pack 1 a starších verzích volání této metody vyvolá ArgumentOutOfRangeException , pokud vložení value způsobí, že celková délka objektu překročí MaxCapacity. Počínaje rozhraním .NET Framework 4 vyvolá metoda .OutOfMemoryException

Viz také

Platí pro

Insert(Int32, Boolean)

Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs
Zdroj:
StringBuilder.cs

Vloží řetězcovou reprezentaci logické hodnoty do této instance na pozici zadaného znaku.

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

Parametry

index
Int32

Pozice v tomto případě, kde začíná vkládání.

value
Boolean

Hodnota, která se má vložit.

Návraty

Odkaz na tuto instanci po dokončení operace vložení.

Výjimky

index je menší než nula nebo větší než délka této instance.

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Boolean.ToString slouží k získání řetězcové reprezentace value. Stávající znaky se posunou, aby uvolnily místo pro nový text. Kapacita se upraví podle potřeby.

Poznámky pro volající

V rozhraní .NET Framework 3.5 Service Pack 1 a starších verzích volání této metody vyvolá ArgumentOutOfRangeException , pokud vložení value způsobí, že celková délka objektu překročí MaxCapacity. Počínaje rozhraním .NET Framework 4 vyvolá metoda .OutOfMemoryException

Viz také

Platí pro