StringBuilder.Insert Yöntem

Başvuru

Tanım

Ad Alanı:: System.Text

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirtilen bir nesnenin dize gösterimini belirtilen karakter konumunda bu örneğe ekler.

Aşırı Yüklemeler

Insert(Int32, String)	Bu örneğe belirtilen karakter konumunda bir dize ekler.
Insert(Int32, Single)	Belirtilen karakter konumunda bu örneğe tek duyarlıklı kayan nokta sayısının dize gösterimini ekler.
Insert(Int32, UInt16)	Belirtilen karakter konumundaki bu örneğe 16 bit işaretsiz tamsayının dize gösterimini ekler.
Insert(Int32, Int16)	Belirtilen 16 bit imzalı tamsayının dize gösterimini belirtilen karakter konumunda bu örneğe ekler.
Insert(Int32, UInt64)	Belirtilen karakter konumundaki bu örneğe 64 bit işaretsiz tamsayının dize gösterimini ekler.
Insert(Int32, String, Int32)	Belirtilen bir dizenin bir veya daha fazla kopyasını belirtilen karakter konumunda bu örneğe ekler.
Insert(Int32, Char[], Int32, Int32)	Belirtilen unicode karakter alt dizisinin dize gösterimini belirtilen karakter konumunda bu örneğe ekler.
Insert(Int32, SByte)	Belirtilen 8 bit imzalı tamsayının dize gösterimini belirtilen karakter konumunda bu örneğe ekler.
Insert(Int32, UInt32)	Belirtilen karakter konumundaki bu örneğe 32 bit işaretsiz tamsayının dize gösterimini ekler.
Insert(Int32, ReadOnlySpan<Char>)	Belirtilen karakter konumundaki bu örneğe karakter sırasını ekler.
Insert(Int32, Double)	Bu örneğe belirtilen karakter konumunda çift duyarlıklı kayan nokta sayısının dize gösterimini ekler.
Insert(Int32, Int64)	Belirtilen karakter konumunda bu örneğe 64 bit imzalı tamsayının dize gösterimini ekler.
Insert(Int32, Int32)	Belirtilen 32 bit imzalı tamsayının dize gösterimini belirtilen karakter konumunda bu örneğe ekler.
Insert(Int32, Object)	Bir nesnenin dize gösterimini belirtilen karakter konumunda bu örneğe ekler.
Insert(Int32, Decimal)	Belirtilen karakter konumunda bu örneğe ondalık bir sayının dize gösterimini ekler.
Insert(Int32, Char[])	Belirtilen karakter konumundaki bu örneğe belirtilen Unicode karakter dizisinin dize gösterimini ekler.
Insert(Int32, Char)	Belirtilen Unicode karakterinin dize gösterimini belirtilen karakter konumunda bu örneğe ekler.
Insert(Int32, Byte)	Belirtilen 8 bit işaretsiz tamsayının dize gösterimini belirtilen karakter konumunda bu örneğe ekler.
Insert(Int32, Boolean)	Bir Boole değerinin dize gösterimini belirtilen karakter konumunda bu örneğe ekler.

Örnekler

Aşağıdaki örnekte yöntemi gösterilmektedir 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)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Bu örneğe belirtilen karakter konumunda bir dize ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: String

Eklenecek dize.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin geçerli uzunluğundan büyük.

-veya-

Bu StringBuilder nesnenin geçerli uzunluğu artı uzunluğu value değerini aşıyor MaxCapacity.

Açıklamalar

Yeni metne yer açmak için mevcut karakterler kaydırılır. Kapasite gerektiği gibi ayarlanır.

bu örneği StringBuilder ise veya valuenull değilse değiştirilmez valuenull, ancak uzunluğu sıfırdır.

Ayrıca bkz.

String

Şunlara uygulanır

Insert(Int32, Single)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Belirtilen karakter konumunda bu örneğe tek duyarlıklı kayan nokta sayısının dize gösterimini ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: Single

Eklenecek değer.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

OutOfMemoryException

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

Single.ToString , dize gösterimini valuealmak için kullanılır. Yeni metne yer açmak için mevcut karakterler kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Framework 3.5 Service Pack 1 ve önceki sürümlerinde, eklemenin value nesnenin toplam uzunluğunun aşmasına MaxCapacityneden olması durumunda bu yönteme yapılan çağrılar bir ArgumentOutOfRangeException verdi. .NET Framework 4'den başlayarak yöntemi bir OutOfMemoryExceptionoluşturur.

Ayrıca bkz.

Single

Şunlara uygulanır

Insert(Int32, UInt16)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen karakter konumundaki bu örneğe 16 bit işaretsiz tamsayının dize gösterimini ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: UInt16

Eklenecek değer.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Öznitelikler: CLSCompliantAttribute

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

OutOfMemoryException

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

UInt16.ToString , dize gösterimini valuealmak için kullanılır. Yeni metne yer açmak için mevcut karakterler kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

Ayrıca bkz.

UInt16

Şunlara uygulanır

Insert(Int32, Int16)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Belirtilen 16 bit imzalı tamsayının dize gösterimini belirtilen karakter konumunda bu örneğe ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: Int16

Eklenecek değer.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

OutOfMemoryException

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

Int16.ToString , dize gösterimini valuealmak için kullanılır. Yeni metne yer açmak için mevcut karakterler kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

Ayrıca bkz.

Int16

Şunlara uygulanır

Insert(Int32, UInt64)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen karakter konumundaki bu örneğe 64 bit işaretsiz tamsayının dize gösterimini ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: UInt64

Eklenecek değer.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Öznitelikler: CLSCompliantAttribute

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

OutOfMemoryException

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

UInt64.ToString , dize gösterimini valuealmak için kullanılır. Yeni metne yer açmak için mevcut karakterler kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

Ayrıca bkz.

UInt64

Şunlara uygulanır

Insert(Int32, String, Int32)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Belirtilen bir dizenin bir veya daha fazla kopyasını belirtilen karakter konumunda bu örneğe ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: String

Eklenecek dize.

count: Int32

ekleme valuesayısı.

Döndürülenler

StringBuilder

Ekleme tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin geçerli uzunluğundan büyük.

-veya-

count, sıfırdan küçüktür.

OutOfMemoryException

Bu StringBuilder nesnenin geçerli uzunluğu ve süre count uzunluğu value değerini aşıyorMaxCapacity.

Açıklamalar

Var olan karakterler, yeni metne yer açmak için kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Bu StringBuilder nesne ise değiştirilmez valuenull, valuenull ancak uzunluğu sıfır veya count sıfırdır.

Ayrıca bkz.

String

Şunlara uygulanır

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

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Belirtilen karakter konumundaki bu örneğe, belirtilen Unicode karakterlerinin belirtilen alt dizisinin dize gösterimini ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: Char[]

Karakter dizisi.

startIndex: Int32

içindeki valuebaşlangıç dizini.

charCount: Int32

Eklenecek karakter sayısı.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentNullException

value , nullve startIndexcharCount sıfır değildir.

ArgumentOutOfRangeException

index, startIndexveya charCount sıfırdan küçüktür.

-veya-

index bu örneğin uzunluğundan daha büyük.

-veya-

startIndex artı charCount içinde valuebir konum değildir.

-veya-

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Var olan karakterler, yeni metne yer açmak için kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Şunlara uygulanır

Insert(Int32, SByte)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 8 bit imzalı tamsayının dize gösterimini bu örneğe belirtilen karakter konumunda ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: SByte

Eklenecek değer.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Öznitelikler: CLSCompliantAttribute

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

OutOfMemoryException

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

SByte.ToString dize gösterimini valuealmak için kullanılır. Var olan karakterler, yeni metne yer açmak için kaydırılır. Kapasite gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Framework 3.5 Service Pack 1 ve önceki sürümlerinde, bu yönteme yapılan çağrılar, eklemenin value nesnenin toplam uzunluğunun aşmasına MaxCapacityneden olması durumunda bir ArgumentOutOfRangeException attı. .NET Framework 4'den başlayarak yöntemi bir OutOfMemoryExceptionoluşturur.

Ayrıca bkz.

SByte

Şunlara uygulanır

Insert(Int32, UInt32)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen karakter konumunda bu örneğe 32 bit işaretsiz tamsayının dize gösterimini ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: UInt32

Eklenecek değer.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Öznitelikler: CLSCompliantAttribute

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

OutOfMemoryException

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

UInt32.ToString dize gösterimini valuealmak için kullanılır. Var olan karakterler, yeni metne yer açmak için kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

Ayrıca bkz.

UInt32

Şunlara uygulanır

Insert(Int32, ReadOnlySpan<Char>)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Belirtilen karakter konumunda bu örneğe karakter sırasını ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: ReadOnlySpan<Char>

Eklenecek karakter aralığı.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Açıklamalar

Varolan karakterler, karakter dizisinin value eklenmesi için yer açmak üzere kaydırılır. Kapasite gerektiği gibi ayarlanır.

Şunlara uygulanır

Insert(Int32, Double)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Belirtilen karakter konumunda bu örneğe çift duyarlıklı kayan nokta sayısının dize gösterimini ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: Double

Eklenecek değer.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

OutOfMemoryException

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Double.ToString dize gösterimini valuealmak için kullanılır. Var olan karakterler, yeni metne yer açmak için kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

Ayrıca bkz.

Double

Şunlara uygulanır

Insert(Int32, Int64)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Belirtilen karakter konumunda bu örneğe 64 bit imzalı tamsayının dize gösterimini ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: Int64

Eklenecek değer.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

OutOfMemoryException

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Int64.ToString dize gösterimini valuealmak için kullanılır. Var olan karakterler, yeni metne yer açmak için kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

Ayrıca bkz.

Int64

Şunlara uygulanır

Insert(Int32, Int32)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Belirtilen 32 bit imzalı tamsayının dize gösterimini bu örneğe belirtilen karakter konumunda ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: Int32

Eklenecek değer.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

OutOfMemoryException

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Int32.ToString dize gösterimini valuealmak için kullanılır. Var olan karakterler, yeni metne yer açmak için kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

Ayrıca bkz.

Int32

Şunlara uygulanır

Insert(Int32, Object)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Bir nesnenin dize gösterimini belirtilen karakter konumunda bu örneğe ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: Object

Eklenecek nesne veya null.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

OutOfMemoryException

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Object.ToString dize gösterimini valuealmak için kullanılır. Var olan karakterler, yeni metne yer açmak için kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

ise valuenull, bu örneğin değeri değişmez.

Arayanlara Notlar

Ayrıca bkz.

Object

Şunlara uygulanır

Insert(Int32, Decimal)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Belirtilen karakter konumunda bu örneğe ondalık bir sayının dize gösterimini ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: Decimal

Eklenecek değer.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

OutOfMemoryException

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

Decimal.ToString , dize gösterimini valuealmak için kullanılır. Yeni metne yer açmak için mevcut karakterler kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

Ayrıca bkz.

Decimal

Şunlara uygulanır

Insert(Int32, Char[])

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Belirtilen karakter konumundaki bu örneğe belirtilen Unicode karakter dizisinin dize gösterimini ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: Char[]

Eklenecek karakter dizisi.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

-veya-

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

Yeni metne yer açmak için mevcut karakterler kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

ise valuenullStringBuilder, değiştirilmez.

Şunlara uygulanır

Insert(Int32, Char)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Belirtilen Unicode karakterinin dize gösterimini belirtilen karakter konumunda bu örneğe ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: Char

Eklenecek değer.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

-veya-

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

Char.ToString , dize gösterimini valuealmak için kullanılır. Yeni metne yer açmak için mevcut karakterler kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Ayrıca bkz.

Char

Şunlara uygulanır

Insert(Int32, Byte)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Belirtilen 8 bit işaretsiz tamsayının dize gösterimini belirtilen karakter konumunda bu örneğe ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: Byte

Eklenecek değer.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

OutOfMemoryException

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

Byte.ToString , dize gösterimini valuealmak için kullanılır. Yeni metne yer açmak için mevcut karakterler kaydırılır. Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

Ayrıca bkz.

Byte

Şunlara uygulanır

Insert(Int32, Boolean)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

Bir Boole değerinin dize gösterimini belirtilen karakter konumunda bu örneğe ekler.

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

Parametreler

index: Int32

Bu örnekte eklemenin başladığı konum.

value: Boolean

Eklenecek değer.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

index sıfırdan küçük veya bu örneğin uzunluğundan büyük.

OutOfMemoryException

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

Boolean.ToString , dize gösterimini valuealmak için kullanılır. Yeni metne yer açmak için mevcut karakterler kaydırılır. Kapasite gerektiği gibi ayarlanır.

Arayanlara Notlar

Ayrıca bkz.

Boolean

Şunlara uygulanır