StringBuilder.Insert Metode

Referensi

Definisi

Ruang nama:: System.Text

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyisipkan representasi string objek tertentu ke dalam instans ini pada posisi karakter tertentu.

Overload

Insert(Int32, String)	Menyisipkan string ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Single)	Menyisipkan representasi string dari angka titik floating presisi tunggal ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, UInt16)	Menyisipkan representasi string dari bilangan bulat yang tidak ditandatangani 16-bit ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Int16)	Menyisipkan representasi string dari bilangan bulat bertanda 16-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, UInt64)	Menyisipkan representasi string dari bilangan bulat yang tidak ditandatangani 64-bit ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, String, Int32)	Menyisipkan satu atau beberapa salinan string tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Char[], Int32, Int32)	Menyisipkan representasi string dari subarray karakter Unicode tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, SByte)	Menyisipkan representasi string dari bilangan bulat bertanda 8-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, UInt32)	Menyisipkan representasi string dari bilangan bulat yang tidak ditandatangani 32-bit ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, ReadOnlySpan<Char>)	Menyisipkan urutan karakter ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Double)	Menyisipkan representasi string dari angka floating-point presisi ganda ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Int64)	Menyisipkan representasi string dari bilangan bulat bertanda 64-bit ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Int32)	Menyisipkan representasi string dari bilangan bulat bertanda 32-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Object)	Menyisipkan representasi string objek ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Decimal)	Menyisipkan representasi string dari angka desimal ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Char[])	Menyisipkan representasi string dari array karakter Unicode tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Char)	Menyisipkan representasi string dari karakter Unicode tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Byte)	Menyisipkan representasi string dari bilangan bulat yang tidak ditandatangani 8-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Boolean)	Menyisipkan representasi string dari nilai Boolean ke dalam instans ini pada posisi karakter yang ditentukan.

Contoh

Contoh berikut menunjukkan Insert metode .

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)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan string ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam contoh ini di mana penyisipan dimulai.

value: String

String yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini saat ini.

-atau-

Panjang objek ini saat ini StringBuilder ditambah panjang value melebihi MaxCapacity.

Keterangan

Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas disesuaikan sesuai kebutuhan.

Instans StringBuilder ini tidak diubah jika value adalah null, atau value tidak null tetapi panjangnya nol.

Lihat juga

String

Berlaku untuk

Insert(Int32, Single)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan representasi string dari angka titik floating presisi tunggal ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam contoh ini di mana penyisipan dimulai.

value: Single

Nilai yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

OutOfMemoryException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Single.ToString digunakan untuk mendapatkan representasi string dari value. Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Dalam .NET Framework 3.5 Paket Layanan 1 dan versi yang lebih lama, panggilan ke metode ini melemparkan ArgumentOutOfRangeException jika penyisipan value akan menyebabkan panjang total objek melebihi MaxCapacity. Dimulai dengan .NET Framework 4, metode melempar OutOfMemoryException.

Lihat juga

Single

Berlaku untuk

Insert(Int32, UInt16)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Penting

API ini bukan kompatibel CLS.

Menyisipkan representasi string dari bilangan bulat yang tidak ditandatangani 16-bit ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam contoh ini di mana penyisipan dimulai.

value: UInt16

Nilai yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Atribut: CLSCompliantAttribute

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

OutOfMemoryException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

UInt16.ToString digunakan untuk mendapatkan representasi string dari value. Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

UInt16

Berlaku untuk

Insert(Int32, Int16)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan representasi string dari bilangan bulat bertanda 16-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam contoh ini di mana penyisipan dimulai.

value: Int16

Nilai yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

OutOfMemoryException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Int16.ToString digunakan untuk mendapatkan representasi string dari value. Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Int16

Berlaku untuk

Insert(Int32, UInt64)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Penting

API ini bukan kompatibel CLS.

Menyisipkan representasi string dari bilangan bulat yang tidak ditandatangani 64-bit ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam contoh ini di mana penyisipan dimulai.

value: UInt64

Nilai yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Atribut: CLSCompliantAttribute

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

OutOfMemoryException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

UInt64.ToString digunakan untuk mendapatkan representasi string dari value. Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

UInt64

Berlaku untuk

Insert(Int32, String, Int32)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan satu atau beberapa salinan string tertentu ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam contoh ini di mana penyisipan dimulai.

value: String

String yang akan disisipkan.

count: Int32

Jumlah waktu untuk menyisipkan value.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah penyisipan selesai.

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini saat ini.

-atau-

count kurang dari nol.

OutOfMemoryException

Panjang objek ini saat ini StringBuilder ditambah panjang value waktu count melebihi MaxCapacity.

Keterangan

Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Objek ini StringBuilder tidak diubah jika value adalah null, value bukan null tetapi panjangnya nol, atau count nol.

Lihat juga

String

Berlaku untuk

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

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan representasi string dari subarray karakter Unicode tertentu ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam contoh ini di mana penyisipan dimulai.

value: Char[]

Array karakter.

startIndex: Int32

Indeks awal dalam value.

charCount: Int32

Jumlah karakter yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Pengecualian

ArgumentNullException

value adalah null, dan startIndex dan charCount bukan nol.

ArgumentOutOfRangeException

index, startIndex, atau charCount kurang dari nol.

-atau-

index lebih besar dari panjang instans ini.

-atau-

startIndex plus charCount bukan posisi dalam value.

-atau-

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Berlaku untuk

Insert(Int32, SByte)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Penting

API ini bukan kompatibel CLS.

Menyisipkan representasi string dari bilangan bulat bertanda 8-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam contoh ini di mana penyisipan dimulai.

value: SByte

Nilai yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Atribut: CLSCompliantAttribute

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

OutOfMemoryException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

SByte.ToString digunakan untuk mendapatkan representasi string dari value. Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

SByte

Berlaku untuk

Insert(Int32, UInt32)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Penting

API ini bukan kompatibel CLS.

Menyisipkan representasi string dari bilangan bulat yang tidak ditandatangani 32-bit ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam contoh ini di mana penyisipan dimulai.

value: UInt32

Nilai yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Atribut: CLSCompliantAttribute

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

OutOfMemoryException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

UInt32.ToString digunakan untuk mendapatkan representasi string dari value. Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

UInt32

Berlaku untuk

Insert(Int32, ReadOnlySpan<Char>)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan urutan karakter ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam contoh ini di mana penyisipan dimulai.

value: ReadOnlySpan<Char>

Rentang karakter untuk disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Keterangan

Karakter yang ada digeser untuk memberi ruang bagi urutan karakter di value untuk menyisipkannya. Kapasitas disesuaikan sesuai kebutuhan.

Berlaku untuk

Insert(Int32, Double)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan representasi string dari angka floating-point presisi ganda ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam contoh ini di mana penyisipan dimulai.

value: Double

Nilai yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

OutOfMemoryException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Double.ToString digunakan untuk mendapatkan representasi string dari value. Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Double

Berlaku untuk

Insert(Int32, Int64)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan representasi string dari bilangan bulat bertanda 64-bit ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam contoh ini di mana penyisipan dimulai.

value: Int64

Nilai yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

OutOfMemoryException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Int64.ToString digunakan untuk mendapatkan representasi string dari value. Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Int64

Berlaku untuk

Insert(Int32, Int32)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan representasi string dari bilangan bulat bertanda 32-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam contoh ini di mana penyisipan dimulai.

value: Int32

Nilai yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

OutOfMemoryException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Int32.ToString digunakan untuk mendapatkan representasi string dari value. Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Int32

Berlaku untuk

Insert(Int32, Object)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan representasi string objek ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam contoh ini di mana penyisipan dimulai.

value: Object

Objek yang akan disisipkan, atau null.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

OutOfMemoryException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Object.ToString digunakan untuk mendapatkan representasi string dari value. Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Jika value adalah null, nilai instans ini tidak berubah.

Catatan Bagi Pemanggil

Lihat juga

Object

Berlaku untuk

Insert(Int32, Decimal)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan representasi string dari angka desimal ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam instans ini di mana penyisipan dimulai.

value: Decimal

Nilai yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

OutOfMemoryException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Decimal.ToString digunakan untuk mendapatkan representasi string dari value. Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Decimal

Berlaku untuk

Insert(Int32, Char[])

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan representasi string dari array karakter Unicode tertentu ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam instans ini di mana penyisipan dimulai.

value: Char[]

Array karakter yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

-atau-

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Jika value adalah null, StringBuilder tidak diubah.

Berlaku untuk

Insert(Int32, Char)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan representasi string dari karakter Unicode tertentu ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam instans ini di mana penyisipan dimulai.

value: Char

Nilai yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

-atau-

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Char.ToString digunakan untuk mendapatkan representasi string dari value. Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Lihat juga

Char

Berlaku untuk

Insert(Int32, Byte)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan representasi string dari bilangan bulat yang tidak ditandatangani 8-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam instans ini di mana penyisipan dimulai.

value: Byte

Nilai yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

OutOfMemoryException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Byte.ToString digunakan untuk mendapatkan representasi string dari value. Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Dalam .NET Framework 3.5 Paket Layanan 1 dan versi yang lebih lama, panggilan ke metode ini melemparkan ArgumentOutOfRangeException jika menyisipkan value akan menyebabkan panjang total objek melebihi MaxCapacity. Dimulai dengan .NET Framework 4, metode melempar OutOfMemoryException.

Lihat juga

Byte

Berlaku untuk

Insert(Int32, Boolean)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menyisipkan representasi string dari nilai Boolean ke dalam instans ini pada posisi karakter yang ditentukan.

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

Posisi dalam instans ini di mana penyisipan dimulai.

value: Boolean

Nilai yang akan disisipkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penyisipan selesai.

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol atau lebih besar dari panjang instans ini.

OutOfMemoryException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Boolean.ToString digunakan untuk mendapatkan representasi string dari value. Karakter yang ada digeser untuk memberi ruang bagi teks baru. Kapasitas disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Boolean

Berlaku untuk