StringBuilder.Insert Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Text

Zestaw:: System.Runtime.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wstawia reprezentację ciągu określonego obiektu w tym wystąpieniu w określonym położeniu znaku.

Przeciążenia

Insert(Int32, String)	Wstawia ciąg do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Single)	Wstawia ciąg reprezentujący liczbę zmiennoprzecinkową o pojedynczej precyzji do tego wystąpienia w określonej pozycji znaku.
Insert(Int32, UInt16)	Wstawia do tego wystąpienia reprezentację ciągu 16-bitowej liczby całkowitej bez znaku w określonym położeniu znaku.
Insert(Int32, Int16)	Wstawia reprezentację ciągu określonej 16-bitowej liczby całkowitej ze znakiem do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, UInt64)	Wstawia do tego wystąpienia reprezentację ciągu 64-bitowej liczby całkowitej bez znaku w określonym położeniu znaku.
Insert(Int32, String, Int32)	Wstawia co najmniej jedną kopię określonego ciągu do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Char[], Int32, Int32)	Wstawia reprezentację ciągu określonej podtablicy znaków Unicode do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, SByte)	Wstawia reprezentację ciągu określonej 8-bitowej liczby całkowitej ze znakiem do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, UInt32)	Wstawia do tego wystąpienia reprezentację ciągu 32-bitowej liczby całkowitej bez znaku w określonym położeniu znaku.
Insert(Int32, ReadOnlySpan<Char>)	Wstawia sekwencję znaków do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Double)	Wstawia reprezentację ciągu liczby zmiennoprzecinkowe o podwójnej precyzji do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Int64)	Wstawia reprezentację ciągu 64-bitowej liczby całkowitej ze znakiem do tego wystąpienia w określonej pozycji znaku.
Insert(Int32, Int32)	Wstawia reprezentację ciągu określonej 32-bitowej liczby całkowitej ze znakiem do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Object)	Wstawia reprezentację ciągu obiektu w tym wystąpieniu w określonym położeniu znaku.
Insert(Int32, Decimal)	Wstawia reprezentację ciągu liczby dziesiętnej do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Char[])	Wstawia reprezentację ciągu określonej tablicy znaków Unicode do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Char)	Wstawia do tego wystąpienia reprezentację ciągu określonego znaku Unicode w określonym położeniu znaku.
Insert(Int32, Byte)	Wstawia reprezentację ciągu określonej 8-bitowej liczby całkowitej bez znaku do tego wystąpienia w określonym położeniu znaku.
Insert(Int32, Boolean)	Wstawia reprezentację ciągu wartości logicznej w tym wystąpieniu w określonym położeniu znaku.

Przykłady

W poniższym przykładzie pokazano metodę 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, String)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia ciąg do tego wystąpienia w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawianie.

value: String

Ciąg do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż bieżąca długość tego wystąpienia.

-lub-

Bieżąca długość tego StringBuilder obiektu oraz długość value przekracza MaxCapacitywartość .

Uwagi

Istniejące znaki są przesunięte w celu zmiany miejsca na nowy tekst. Pojemność jest dostosowywana zgodnie z potrzebami.

To wystąpienie StringBuilder nie jest zmieniane, jeśli value jest null, lub value nie null , ale jego długość jest równa zero.

Zobacz też

String

Dotyczy

Insert(Int32, Single)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia ciąg reprezentujący liczbę zmiennoprzecinkową o pojedynczej precyzji do tego wystąpienia w określonej pozycji 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawianie.

value: Single

Wartość do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

OutOfMemoryException

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Single.ToString służy do uzyskiwania reprezentacji valueciągu . Istniejące znaki są przesunięte w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

W .NET Framework 3.5 z dodatkiem Service Pack 1 i jego wcześniejszymi wersjami wywołania tej metody spowodowałyArgumentOutOfRangeException, że wstawianie value spowodowałoby przekroczenie MaxCapacitycałkowitej długości obiektu . Począwszy od .NET Framework 4, metoda zgłasza błąd OutOfMemoryException.

Zobacz też

Single

Dotyczy

Insert(Int32, UInt16)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Wstawia do tego wystąpienia reprezentację ciągu 16-bitowej liczby całkowitej bez znaku w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawianie.

value: UInt16

Wartość do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Atrybuty: CLSCompliantAttribute

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

OutOfMemoryException

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

UInt16.ToString służy do uzyskiwania reprezentacji valueciągu . Istniejące znaki są przesunięte w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Zobacz też

UInt16

Dotyczy

Insert(Int32, Int16)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia reprezentację ciągu określonej 16-bitowej liczby całkowitej ze znakiem do tego wystąpienia w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawianie.

value: Int16

Wartość do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

OutOfMemoryException

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Int16.ToString służy do uzyskiwania reprezentacji valueciągu . Istniejące znaki są przesunięte w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Zobacz też

Int16

Dotyczy

Insert(Int32, UInt64)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Wstawia do tego wystąpienia reprezentację ciągu 64-bitowej liczby całkowitej bez znaku w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawianie.

value: UInt64

Wartość do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Atrybuty: CLSCompliantAttribute

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

OutOfMemoryException

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

UInt64.ToString służy do uzyskiwania reprezentacji valueciągu . Istniejące znaki są przesunięte w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Zobacz też

UInt64

Dotyczy

Insert(Int32, String, Int32)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia co najmniej jedną kopię określonego ciągu do tego wystąpienia w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawianie.

value: String

Ciąg do wstawienia.

count: Int32

Liczba razy do wstawienia value.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu wstawiania.

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż bieżąca długość tego wystąpienia.

-lub-

Parametr count ma wartość niższą niż zero.

OutOfMemoryException

Bieżąca długość tego StringBuilder obiektu oraz długość value czasu count przekracza MaxCapacitywartość .

Uwagi

Istniejące znaki są przesunięte w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Ten StringBuilder obiekt nie jest zmieniany, jeśli value ma nullwartość , nie null ma wartości , value ale jego długość wynosi zero lub count jest równa zero.

Zobacz też

String

Dotyczy

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

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia reprezentację ciągu określonej podtablicy znaków Unicode do tego wystąpienia w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawianie.

value: Char[]

Tablica znaków.

startIndex: Int32

Indeks początkowy w obrębie value.

charCount: Int32

Liczba znaków do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Wyjątki

ArgumentNullException

value to null, i startIndexcharCount nie są zerowe.

ArgumentOutOfRangeException

index, startIndexlub charCount jest mniejsza niż zero.

-lub-

index jest większa niż długość tego wystąpienia.

-lub-

startIndex plus charCount nie jest pozycją w obrębie value.

-lub-

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Istniejące znaki są przesunięte w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Dotyczy

Insert(Int32, SByte)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Wstawia reprezentację ciągu określonej 8-bitowej liczby całkowitej ze znakiem do tego wystąpienia w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawianie.

value: SByte

Wartość do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Atrybuty: CLSCompliantAttribute

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

OutOfMemoryException

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

SByte.ToString służy do uzyskiwania reprezentacji valueciągu . Istniejące znaki są przesunięte w celu zmiany miejsca na nowy tekst. Pojemność jest dostosowywana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Zobacz też

SByte

Dotyczy

Insert(Int32, UInt32)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Wstawia do tego wystąpienia reprezentację ciągu 32-bitowej liczby całkowitej bez znaku w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawianie.

value: UInt32

Wartość do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Atrybuty: CLSCompliantAttribute

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

OutOfMemoryException

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

UInt32.ToString służy do uzyskiwania reprezentacji valueciągu . Istniejące znaki są przesunięte w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Zobacz też

UInt32

Dotyczy

Insert(Int32, ReadOnlySpan<Char>)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia sekwencję znaków do tego wystąpienia w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawianie.

value: ReadOnlySpan<Char>

Zakres znaków do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Uwagi

Istniejące znaki są przesunięte, aby zapewnić miejsce na sekwencję znaków w obiekcie , value aby ją wstawić. Pojemność jest dostosowywana zgodnie z potrzebami.

Dotyczy

Insert(Int32, Double)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia reprezentację ciągu liczby zmiennoprzecinkowe o podwójnej precyzji do tego wystąpienia w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawianie.

value: Double

Wartość do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

OutOfMemoryException

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Double.ToString służy do uzyskiwania reprezentacji valueciągu . Istniejące znaki są przesunięte w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Zobacz też

Double

Dotyczy

Insert(Int32, Int64)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia reprezentację ciągu 64-bitowej liczby całkowitej ze znakiem do tego wystąpienia w określonej pozycji 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawianie.

value: Int64

Wartość do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

OutOfMemoryException

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Int64.ToString służy do uzyskiwania reprezentacji valueciągu . Istniejące znaki są przesunięte w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Zobacz też

Int64

Dotyczy

Insert(Int32, Int32)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia reprezentację ciągu określonej 32-bitowej liczby całkowitej ze znakiem do tego wystąpienia w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawianie.

value: Int32

Wartość do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

OutOfMemoryException

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Int32.ToString służy do uzyskiwania reprezentacji valueciągu . Istniejące znaki są przesunięte w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Zobacz też

Int32

Dotyczy

Insert(Int32, Object)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia reprezentację ciągu obiektu w tym wystąpieniu w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawianie.

value: Object

Obiekt do wstawienia lub null.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

OutOfMemoryException

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Object.ToString służy do uzyskiwania reprezentacji valueciągu . Istniejące znaki są przesunięte w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Jeśli value parametr ma nullwartość , wartość tego wystąpienia jest niezmieniona.

Uwagi dotyczące wywoływania

Zobacz też

Object

Dotyczy

Insert(Int32, Decimal)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia reprezentację ciągu liczby dziesiętnej do tego wystąpienia w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawienie.

value: Decimal

Wartość do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

OutOfMemoryException

Rozszerzenie wartości tego wystąpienia spowoduje przekroczenie wartości MaxCapacity.

Uwagi

Decimal.ToStringsłuży do uzyskiwania reprezentacji ciągu .value Istniejące znaki są przesuwane w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowywana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Zobacz też

Decimal

Dotyczy

Insert(Int32, Char[])

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia reprezentację ciągu określonej tablicy znaków Unicode w tym wystąpieniu w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawienie.

value: Char[]

Tablica znaków do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

-lub-

Rozszerzenie wartości tego wystąpienia spowoduje przekroczenie wartości MaxCapacity.

Uwagi

Istniejące znaki są przesuwane w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowywana zgodnie z potrzebami.

Jeśli value wartość to null, nie zostanie zmieniona StringBuilder .

Dotyczy

Insert(Int32, Char)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia reprezentację ciągu określonego znaku Unicode w tym wystąpieniu w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawienie.

value: Char

Wartość do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

-lub-

Rozszerzenie wartości tego wystąpienia spowoduje przekroczenie wartości MaxCapacity.

Uwagi

Char.ToStringsłuży do uzyskiwania reprezentacji ciągu .value Istniejące znaki są przesuwane w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowywana zgodnie z potrzebami.

Zobacz też

Char

Dotyczy

Insert(Int32, Byte)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia reprezentację ciągu określonej 8-bitowej liczby całkowitej bez znaku do tego wystąpienia w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawienie.

value: Byte

Wartość do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

OutOfMemoryException

Rozszerzenie wartości tego wystąpienia spowoduje przekroczenie wartości MaxCapacity.

Uwagi

Byte.ToStringsłuży do uzyskiwania reprezentacji ciągu .value Istniejące znaki są przesuwane w celu zmiany miejsca na nowy tekst. Pojemność tego wystąpienia jest dostosowywana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

W .NET Framework 3.5 z dodatkiem Service Pack 1 i starszymi wersjami wywołania tej metody spowodowałyby ArgumentOutOfRangeExceptionvalue przekroczenie MaxCapacitycałkowitej długości obiektu. Począwszy od .NET Framework 4, metoda zgłasza wartość OutOfMemoryException.

Zobacz też

Byte

Dotyczy

Insert(Int32, Boolean)

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Źródło:: StringBuilder.cs

Wstawia reprezentację ciągu wartości logicznej w tym wystąpieniu w określonym położeniu 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

Pozycja w tym wystąpieniu, w którym rozpoczyna się wstawienie.

value: Boolean

Wartość do wstawienia.

Zwraca

StringBuilder

Odwołanie do tego wystąpienia po zakończeniu operacji wstawiania.

Wyjątki

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż długość tego wystąpienia.

OutOfMemoryException

Rozszerzenie wartości tego wystąpienia spowoduje przekroczenie wartości MaxCapacity.

Uwagi

Boolean.ToStringsłuży do uzyskiwania reprezentacji ciągu .value Istniejące znaki są przesuwane w celu zmiany miejsca na nowy tekst. Pojemność jest dostosowywana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Zobacz też

Boolean

Dotyczy