StringBuilder.Insert 方法

參考

定義

命名空間:: System.Text

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

在指定的字元位置上將指定物件的字串表示插入這個執行個體。

多載

Insert(Int32, SByte)	在指定的字元位置，將所指定帶正負號之 8 位元整數的字串表示插入這個執行個體。
Insert(Int32, Char[], Int32, Int32)	在指定的字元位置上將 Unicode 字元之指定子陣列的字串表示插入這個執行個體。
Insert(Int32, String, Int32)	在指定的字元位置上將指定字串的一或多個複本插入這個執行個體。
Insert(Int32, UInt64)	在指定的字元位置，將所指定不帶正負號的 64 位元整數之字串表示插入這個執行個體。
Insert(Int32, UInt32)	在指定的字元位置，將所指定不帶正負號的 32 位元整數之字串表示插入這個執行個體。
Insert(Int32, UInt16)	在指定的字元位置，將所指定不帶正負號的 16 位元整數之字串表示插入這個執行個體。
Insert(Int32, String)	在指定的字元位置上將字串插入這個執行個體。
Insert(Int32, Single)	在指定的字元位置上將單精確度浮點數的字串表示插入這個執行個體。
Insert(Int32, ReadOnlySpan<Char>)	將字元序列插入此執行個體的指定字元位置。
Insert(Int32, Int16)	在指定的字元位置，將所指定帶正負號之 16 位元整數的字串表示插入這個執行個體。
Insert(Int32, Int64)	在指定的字元位置上將指定的 64 位元帶正負號的整數之字串表示插入這個執行個體。
Insert(Int32, Int32)	在指定的字元位置，將所指定帶正負號之 32 位元整數的字串表示插入這個執行個體。
Insert(Int32, Object)	在指定的字元位置上將物件的字串表示插入這個執行個體。
Insert(Int32, Double)	在指定的字元位置上將雙精度浮點數的字串表示插入這個執行個體。
Insert(Int32, Decimal)	在指定的字元位置上將小數位數的字串表示插入這個執行個體。
Insert(Int32, Char[])	在指定的字元位置上將指定的 Unicode 字元陣列之字串表示插入這個執行個體。
Insert(Int32, Char)	在指定的字元位置上將指定的 Unicode 字元之字串表示插入這個執行個體。
Insert(Int32, Byte)	在指定的字元位置上將指定的 8 位元不帶正負號的整數之字串表示插入這個執行個體。
Insert(Int32, Boolean)	在指定的字元位置上將 Boolean 值的字串表示插入這個執行個體。

範例

下列範例示範 Insert 方法。

using namespace System;
using namespace System::Text;
ref class Sample
{
private:

   //                           index: 012345
   static String^ initialValue = "--[]--";
   static StringBuilder^ sb;

public:
   static void Main()
   {
      String^ xyz = "xyz";
      array<Char>^abc = {'a','b','c'};
      Char star = '*';
      Object^ obj = 0;
      bool xBool = true;
      Byte xByte = 1;
      short xInt16 = 2;
      int xInt32 = 3;
      long xInt64 = 4;
      Decimal xDecimal = 5;
      float xSingle = 6.6F;
      double xDouble = 7.7;
      
      // The following types are not CLS-compliant.
      UInt16 xUInt16 = 8;
      UInt32 xUInt32 = 9;
      UInt64 xUInt64 = 10;
      SByte xSByte = -11;
      
      //
      Console::WriteLine( "StringBuilder.Insert method" );
      sb = gcnew StringBuilder( initialValue );
      sb->Insert( 3, xyz, 2 );
      Show( 1, sb );
      sb->Insert( 3, xyz );
      Show( 2, sb );
      sb->Insert( 3, star );
      Show( 3, sb );
      sb->Insert( 3, abc );
      Show( 4, sb );
      sb->Insert( 3, abc, 1, 2 );
      Show( 5, sb );
      sb->Insert( 3, xBool ); // True
      Show( 6, sb );
      sb->Insert( 3, obj ); // 0
      Show( 7, sb );
      sb->Insert( 3, xByte ); // 1
      Show( 8, sb );
      sb->Insert( 3, xInt16 ); // 2
      Show( 9, sb );
      sb->Insert( 3, xInt32 ); // 3
      Show( 10, sb );
      sb->Insert( 3, xInt64 ); // 4
      Show( 11, sb );
      sb->Insert( 3, xDecimal ); // 5
      Show( 12, sb );
      sb->Insert( 3, xSingle ); // 6.6
      Show( 13, sb );
      sb->Insert( 3, xDouble ); // 7.7
      Show( 14, sb );
      
      // The following Insert methods are not CLS-compliant.
      sb->Insert( 3, xUInt16 ); // 8
      Show( 15, sb );
      sb->Insert( 3, xUInt32 ); // 9
      Show( 16, sb );
      sb->Insert( 3, xUInt64 ); // 10
      Show( 17, sb );
      sb->Insert( 3, xSByte ); // -11
      Show( 18, sb );
      
      //
   }

   static void Show( int overloadNumber, StringBuilder^ sbs )
   {
      Console::WriteLine( "{0,2:G} = {1}", overloadNumber, sbs );
      sb = gcnew StringBuilder( initialValue );
   }

};

int main()
{
   Sample::Main();
}

/*
This example produces the following results:

StringBuilder.Insert method
 1 = --[xyzxyz]--
 2 = --[xyz]--
 3 = --[*]--
 4 = --[abc]--
 5 = --[bc]--
 6 = --[True]--
 7 = --[0]--
 8 = --[1]--
 9 = --[2]--
10 = --[3]--
11 = --[4]--
12 = --[5]--
13 = --[6.6]--
14 = --[7.7]--
15 = --[8]--
16 = --[9]--
17 = --[10]--
18 = --[-11]--

*/

using System;
using System.Text;

class Sample
{
//                         index: 012345
    static string initialValue = "--[]--";
    static StringBuilder sb;

    public static void Main()
    {
    string      xyz       = "xyz";
    char[]      abc       = {'a', 'b', 'c'};
    char        star      = '*';
    Object 	obj       = 0;

    bool        xBool     = true;
    byte        xByte     = 1;
    short       xInt16    = 2;
    int         xInt32    = 3;
    long        xInt64    = 4;
    Decimal     xDecimal  = 5;
    float       xSingle   = 6.6F;
    double      xDouble   = 7.7;

// The following types are not CLS-compliant.
    ushort      xUInt16   = 8;
    uint        xUInt32   = 9;
    ulong       xUInt64   = 10;
    sbyte       xSByte    = -11;
//
    Console.WriteLine("StringBuilder.Insert method");
    sb = new StringBuilder(initialValue);

    sb.Insert(3, xyz, 2);
    Show(1, sb);

    sb.Insert(3, xyz);
    Show(2, sb);

    sb.Insert(3, star);
    Show(3, sb);

    sb.Insert(3, abc);
    Show(4, sb);

    sb.Insert(3, abc, 1, 2);
    Show(5, sb);

    sb.Insert(3, xBool);     // True
    Show(6, sb);

    sb.Insert(3, obj);       // 0
    Show(7, sb);

    sb.Insert(3, xByte);     // 1
    Show(8, sb);

    sb.Insert(3, xInt16);    // 2
    Show(9, sb);

    sb.Insert(3, xInt32);    // 3
    Show(10, sb);

    sb.Insert(3, xInt64);    // 4
    Show(11, sb);

    sb.Insert(3, xDecimal);  // 5
    Show(12, sb);

    sb.Insert(3, xSingle);   // 6.6
    Show(13, sb);

    sb.Insert(3, xDouble);   // 7.7
    Show(14, sb);

// The following Insert methods are not CLS-compliant.
    sb.Insert(3, xUInt16);   // 8
    Show(15, sb);

    sb.Insert(3, xUInt32);   // 9
    Show(16, sb);

    sb.Insert(3, xUInt64);   // 10
    Show(17, sb);

    sb.Insert(3, xSByte);    // -11
    Show(18, sb);
//
    }

    public static void Show(int overloadNumber, StringBuilder sbs)
    {
    Console.WriteLine("{0,2:G} = {1}", overloadNumber, sbs.ToString());
    sb = new StringBuilder(initialValue);
    }
}
/*
This example produces the following results:

StringBuilder.Insert method
 1 = --[xyzxyz]--
 2 = --[xyz]--
 3 = --[*]--
 4 = --[abc]--
 5 = --[bc]--
 6 = --[True]--
 7 = --[0]--
 8 = --[1]--
 9 = --[2]--
10 = --[3]--
11 = --[4]--
12 = --[5]--
13 = --[6.6]--
14 = --[7.7]--
15 = --[8]--
16 = --[9]--
17 = --[10]--
18 = --[-11]--

*/

open System.Text

let initialValue = "--[]--"

let show overloadNumber (sbs: StringBuilder) =
    printfn $"{overloadNumber, 2:G} = {sbs}"
    sbs.Clear().Append initialValue |> ignore

let xyz = "xyz"
let abc = [| 'a'; 'b'; 'c' |]
let star = '*'
let obj: obj = 0

let xBool = true
let xByte = 1uy
let xInt16 = 2s
let xInt32 = 3
let xInt64 = 4L
let xDecimal = 5M
let xSingle = 6.6f
let xDouble = 7.7

// The following types are not CLS-compliant.
let xUInt16 = 8us
let xUInt32 = 9u
let xUInt64 = 10uL
let xSByte = -11y

printfn "StringBuilder.Insert method"
let sb = StringBuilder initialValue

sb.Insert(3, xyz, 2) |> ignore
show 1 sb

sb.Insert(3, xyz) |> ignore
show 2 sb

sb.Insert(3, star) |> ignore
show 3 sb

sb.Insert(3, abc) |> ignore
show 4 sb

sb.Insert(3, abc, 1, 2) |> ignore
show 5 sb

sb.Insert(3, xBool) |> ignore // True
show 6 sb

sb.Insert(3, obj) |> ignore // 0
show 7 sb

sb.Insert(3, xByte) |> ignore // 1
show 8 sb

sb.Insert(3, xInt16) |> ignore // 2
show 9 sb

sb.Insert(3, xInt32) |> ignore // 3
show 10 sb

sb.Insert(3, xInt64) |> ignore // 4
show 11 sb

sb.Insert(3, xDecimal) |> ignore // 5
show 12 sb

sb.Insert(3, xSingle) |> ignore // 6.6
show 13 sb

sb.Insert(3, xDouble) |> ignore // 7.7
show 14 sb

// The following Insert methods are not CLS-compliant.
sb.Insert(3, xUInt16) |> ignore // 8
show 15 sb

sb.Insert(3, xUInt32) |> ignore // 9
show 16 sb

sb.Insert(3, xUInt64) |> ignore // 10
show 17 sb

sb.Insert(3, xSByte) |> ignore // -11
show 18 sb

// This example produces the following results:
//       StringBuilder.Insert method
//        1 = --[xyzxyz]--
//        2 = --[xyz]--
//        3 = --[*]--
//        4 = --[abc]--
//        5 = --[bc]--
//        6 = --[True]--
//        7 = --[0]--
//        8 = --[1]--
//        9 = --[2]--
//       10 = --[3]--
//       11 = --[4]--
//       12 = --[5]--
//       13 = --[6.6]--
//       14 = --[7.7]--
//       15 = --[8]--
//       16 = --[9]--
//       17 = --[10]--
//       18 = --[-11]--

Imports System.Text

Class Sample
   '                                 index: 012345
   Private Shared initialValue As String = "--[]--"
   Private Shared sb As StringBuilder
   
   Public Shared Sub Main()
      Dim xyz As String = "xyz"
      Dim abc As Char() =  {"a"c, "b"c, "c"c}
      Dim star As Char = "*"c
      Dim obj As [Object] = 0
      
      Dim xBool As Boolean = True
      Dim xByte As Byte = 1
      Dim xInt16 As Short = 2
      Dim xInt32 As Integer = 3
      Dim xInt64 As Long = 4
      Dim xDecimal As [Decimal] = 5
      Dim xSingle As Single = 6.6F
      Dim xDouble As Double = 7.7
      
      ' The following types are not CLS-compliant.
      ' Dim xUInt16 As System.UInt16 = 8 
      ' Dim xUInt32 As System.UInt32 = 9
      ' Dim xUInt64 As System.UInt64 = 10 
      ' Dim xSByte As System.SByte = - 11
      '
      Console.WriteLine("StringBuilder.Insert method")
      sb = New StringBuilder(initialValue)
      
      sb.Insert(3, xyz, 2)
      Show(1, sb)
      
      sb.Insert(3, xyz)
      Show(2, sb)
      
      sb.Insert(3, star)
      Show(3, sb)
      
      sb.Insert(3, abc)
      Show(4, sb)
      
      sb.Insert(3, abc, 1, 2)
      Show(5, sb)
      
      sb.Insert(3, xBool)     ' True
      Show(6, sb)
      
      sb.Insert(3, obj)       ' 0
      Show(7, sb)
      
      sb.Insert(3, xByte)     ' 1
      Show(8, sb)
      
      sb.Insert(3, xInt16)    ' 2
      Show(9, sb)
      
      sb.Insert(3, xInt32)    ' 3
      Show(10, sb)
      
      sb.Insert(3, xInt64)    ' 4
      Show(11, sb)
      
      sb.Insert(3, xDecimal)  ' 5
      Show(12, sb)
      
      sb.Insert(3, xSingle)   ' 6.6
      Show(13, sb)
      
      sb.Insert(3, xDouble)   ' 7.7
      Show(14, sb)
      
      ' The following Insert methods are not CLS-compliant.
      ' sb.Insert(3, xUInt16) ' 8
      ' sb.Insert(3, xUInt32) ' 9
      ' sb.Insert(3, xUInt64) ' 10
      ' sb.Insert(3, xSByte)  ' -11

   End Sub
   
   Public Shared Sub Show(overloadNumber As Integer, sbs As StringBuilder)
      Console.WriteLine("{0,2:G} = {1}", overloadNumber, sbs.ToString())
      sb = New StringBuilder(initialValue)
   End Sub
End Class
'
'This example produces the following results:
'
'StringBuilder.Insert method
' 1 = --[xyzxyz]--
' 2 = --[xyz]--
' 3 = --[*]--
' 4 = --[abc]--
' 5 = --[bc]--
' 6 = --[True]--
' 7 = --[0]--
' 8 = --[1]--
' 9 = --[2]--
'10 = --[3]--
'11 = --[4]--
'12 = --[5]--
'13 = --[6.6]--
'14 = --[7.7]--
'

Insert(Int32, SByte)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

重要

此 API 不符合 CLS 規範。

在指定的字元位置，將所指定帶正負號之 8 位元整數的字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: SByte

要插入的值。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

屬性: CLSCompliantAttribute

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

OutOfMemoryException

加大此執行個體的值可能會超過 MaxCapacity。

備註

SByte.ToString 用來取得的 value字串表示。現有的字元會移位，讓新文字有空間。視需要調整容量。

給呼叫者的注意事項

在 .NET Framework 3.5 Service Pack 1 和較舊版本中，如果插入value會導致物件的總長度超過 MaxCapacity，則呼叫此方法會擲ArgumentOutOfRangeException回。從 .NET Framework 4 開始，方法會擲回 OutOfMemoryException。

另請參閱

SByte

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

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

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

在指定的字元位置上將 Unicode 字元之指定子陣列的字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: Char[]

字元陣列。

startIndex: Int32

value 內的起始索引。

charCount: Int32

要插入的字元數。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

例外狀況

ArgumentNullException

value 是 null，而 startIndex 和 charCount 不是零。

ArgumentOutOfRangeException

index、startIndex 或 charCount 小於零。

-或-

index 大於這個執行個體的長度。

-或-

startIndex 加上 charCount 不是 value 內的位置。

-或-

加大此執行個體的值可能會超過 MaxCapacity。

備註

現有的字元會移位，讓新文字有空間。視需要調整此實例的容量。

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, String, Int32)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

在指定的字元位置上將指定字串的一或多個複本插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: String

要插入的字串。

count: Int32

要插入 value 的次數。

傳回

StringBuilder

插入作業完成後，這個執行個體的參考。

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體目前的長度。

-或-

count 小於零。

OutOfMemoryException

此 StringBuilder 物件目前的長度加 count 的 value 倍長度，會超過 MaxCapacity。

備註

現有的字元會移位，讓新文字有空間。視需要調整此實例的容量。

如果為 nullvalue ，則不會變更這個StringBuilder物件， valuenull但其長度為零，或count為零。

另請參閱

String

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, UInt64)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

重要

此 API 不符合 CLS 規範。

在指定的字元位置，將所指定不帶正負號的 64 位元整數之字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: UInt64

要插入的值。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

屬性: CLSCompliantAttribute

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

OutOfMemoryException

加大此執行個體的值可能會超過 MaxCapacity。

備註

UInt64.ToString 用來取得的 value字串表示。現有的字元會移位，讓新文字有空間。視需要調整此實例的容量。

給呼叫者的注意事項

另請參閱

UInt64

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, UInt32)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

重要

此 API 不符合 CLS 規範。

在指定的字元位置，將所指定不帶正負號的 32 位元整數之字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: UInt32

要插入的值。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

屬性: CLSCompliantAttribute

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

OutOfMemoryException

加大此執行個體的值可能會超過 MaxCapacity。

備註

UInt32.ToString 用來取得的 value字串表示。現有的字元會移位，讓新文字有空間。此實例的容量會視需要進行調整。

給呼叫者的注意事項

另請參閱

UInt32

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, UInt16)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

重要

此 API 不符合 CLS 規範。

在指定的字元位置，將所指定不帶正負號的 16 位元整數之字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: UInt16

要插入的值。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

屬性: CLSCompliantAttribute

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

OutOfMemoryException

加大此執行個體的值可能會超過 MaxCapacity。

備註

UInt16.ToString 用來取得的 value字串表示。現有的字元會移位，讓新文字有空間。此實例的容量會視需要進行調整。

給呼叫者的注意事項

在 .NET Framework 3.5 Service Pack 1 和舊版中，如果插入value會導致物件的總長度超過 MaxCapacity，則呼叫此方法會擲ArgumentOutOfRangeException回。從 .NET Framework 4 開始，方法會擲回 OutOfMemoryException。

另請參閱

UInt16

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, String)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

在指定的字元位置上將字串插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: String

要插入的字串。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體目前的長度。

-或-

這個 StringBuilder 物件目前的長度加上 value 的長度，會超過 MaxCapacity。

備註

現有的字元會移位，讓新文字有空間。容量會視需要進行調整。

如果 value 為，或 value 不是null，但長度為零，則不會變更的實例StringBuildernull。

另請參閱

String

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, Single)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

在指定的字元位置上將單精確度浮點數的字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: Single

要插入的值。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

OutOfMemoryException

加大此執行個體的值可能會超過 MaxCapacity。

備註

Single.ToString 用來取得的 value字串表示。現有的字元會移位，讓新文字有空間。此實例的容量會視需要進行調整。

給呼叫者的注意事項

另請參閱

Single

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, ReadOnlySpan<Char>)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

將字元序列插入此執行個體的指定字元位置。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: ReadOnlySpan<Char>

要插入的字元範圍。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

備註

現有的字元會移位，讓中的 value 字元順序有空間以插入它。容量會視需要進行調整。

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

Insert(Int32, Int16)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

在指定的字元位置，將所指定帶正負號之 16 位元整數的字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: Int16

要插入的值。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

OutOfMemoryException

加大此執行個體的值可能會超過 MaxCapacity。

備註

Int16.ToString 用來取得的 value字串表示。現有的字元會移位，讓新文字有空間。此實例的容量會視需要進行調整。

給呼叫者的注意事項

另請參閱

Int16

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, Int64)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

在指定的字元位置上將指定的 64 位元帶正負號的整數之字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: Int64

要插入的值。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

OutOfMemoryException

加大此執行個體的值可能會超過 MaxCapacity。

備註

Int64.ToString 用來取得的 value字串表示。現有的字元會移位，讓新文字有空間。此實例的容量會視需要進行調整。

給呼叫者的注意事項

另請參閱

Int64

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, Int32)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

在指定的字元位置，將所指定帶正負號之 32 位元整數的字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: Int32

要插入的值。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

OutOfMemoryException

加大此執行個體的值可能會超過 MaxCapacity。

備註

Int32.ToString 用來取得的 value字串表示。現有的字元會移位，讓新文字有空間。此實例的容量會視需要進行調整。

給呼叫者的注意事項

另請參閱

Int32

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, Object)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

在指定的字元位置上將物件的字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: Object

要插入的物件或 null。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

OutOfMemoryException

加大此執行個體的值可能會超過 MaxCapacity。

備註

Object.ToString 用來取得的 value字串表示。現有的字元會移位，讓新文字有空間。此實例的容量會視需要進行調整。

如果 value 為 null，則這個實例的值不會變更。

給呼叫者的注意事項

另請參閱

Object

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, Double)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

在指定的字元位置上將雙精度浮點數的字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: Double

要插入的值。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

OutOfMemoryException

加大此執行個體的值可能會超過 MaxCapacity。

備註

Double.ToString 用來取得的 value字串表示。現有的字元會移位，讓新文字有空間。此實例的容量會視需要進行調整。

給呼叫者的注意事項

另請參閱

Double

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, Decimal)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

在指定的字元位置上將小數位數的字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: Decimal

要插入的值。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

OutOfMemoryException

加大此執行個體的值可能會超過 MaxCapacity。

備註

Decimal.ToString 用來取得的 value字串表示。現有的字元會移位，讓新文字有空間。視需要調整此實例的容量。

給呼叫者的注意事項

另請參閱

Decimal

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, Char[])

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

在指定的字元位置上將指定的 Unicode 字元陣列之字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: Char[]

要插入的字元陣列。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

-或-

加大此執行個體的值可能會超過 MaxCapacity。

備註

現有的字元會移位，讓新文字有空間。視需要調整此實例的容量。

如果 value 為 null，則 StringBuilder 不會變更。

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, Char)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

在指定的字元位置上將指定的 Unicode 字元之字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: Char

要插入的值。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

-或-

加大此執行個體的值可能會超過 MaxCapacity。

備註

Char.ToString 用來取得的 value字串表示。現有的字元會移位，讓新文字有空間。視需要調整此實例的容量。

另請參閱

Char

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, Byte)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

在指定的字元位置上將指定的 8 位元不帶正負號的整數之字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: Byte

要插入的值。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

OutOfMemoryException

加大此執行個體的值可能會超過 MaxCapacity。

備註

Byte.ToString 用來取得的 value字串表示。現有的字元會移位，讓新文字有空間。視需要調整此實例的容量。

給呼叫者的注意事項

另請參閱

Byte

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Insert(Int32, Boolean)

來源:: StringBuilder.cs

來源:: StringBuilder.cs

來源:: StringBuilder.cs

在指定的字元位置上將 Boolean 值的字串表示插入這個執行個體。

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

參數

index: Int32

這個執行個體中開始插入的位置。

value: Boolean

要插入的值。

傳回

StringBuilder

完成插入作業之後，這個執行個體的參考。

例外狀況

ArgumentOutOfRangeException

index 小於零或大於此執行個體的長度。

OutOfMemoryException

加大此執行個體的值可能會超過 MaxCapacity。

備註

Boolean.ToString 用來取得的 value字串表示。現有的字元會移位，讓新文字有空間。視需要調整容量。

給呼叫者的注意事項

另請參閱

Boolean

適用於

.NET 9 及其他版本

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

AI 技能節

共用方式為

StringBuilder.Insert 方法

定義

多載

範例

Insert(Int32, SByte)

參數

傳回

例外狀況

備註

給呼叫者的注意事項

另請參閱

適用於

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

參數

傳回

例外狀況

備註

適用於

Insert(Int32, String, Int32)

參數

傳回

例外狀況

備註

另請參閱

適用於

Insert(Int32, UInt64)

參數

傳回

例外狀況

備註

給呼叫者的注意事項

另請參閱

適用於

Insert(Int32, UInt32)

參數

傳回

例外狀況

備註

給呼叫者的注意事項

另請參閱

適用於

Insert(Int32, UInt16)

參數

傳回

例外狀況

備註

給呼叫者的注意事項

另請參閱

適用於

Insert(Int32, String)

參數

傳回

例外狀況

備註

另請參閱

適用於

Insert(Int32, Single)

參數

傳回

例外狀況

備註

給呼叫者的注意事項

另請參閱

適用於

Insert(Int32, ReadOnlySpan<Char>)

參數

傳回

備註

適用於

Insert(Int32, Int16)

參數

傳回

例外狀況

備註

給呼叫者的注意事項

另請參閱

適用於

Insert(Int32, Int64)