StringBuilder.Insert メソッド

リファレンス

定義

名前空間:: System.Text

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定されたオブジェクトの文字列表記をこのインスタンスの指定された文字位置に挿入します。

オーバーロード

Insert(Int32, String)	文字列をこのインスタンスの指定した文字位置に挿入します。
Insert(Int32, Single)	単精度浮動小数点数の文字列形式をこのインスタンスの指定した文字位置に挿入します。
Insert(Int32, UInt16)	16 ビット符号なし整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。
Insert(Int32, Int16)	指定した 16 ビット符号付き整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。
Insert(Int32, UInt64)	64 ビット符号なし整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。
Insert(Int32, String, Int32)	指定した文字列の 1 つ以上のコピーをこのインスタンスの指定した文字位置に挿入します。
Insert(Int32, Char[], Int32, Int32)	Unicode 文字の指定した部分配列の文字列形式をこのインスタンスの指定した文字位置に挿入します。
Insert(Int32, SByte)	指定した 8 ビット符号付き整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。
Insert(Int32, UInt32)	32 ビット符号なし整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。
Insert(Int32, ReadOnlySpan<Char>)	文字のシーケンスをこのインスタンスの指定した文字位置に挿入します。
Insert(Int32, Double)	倍精度浮動小数点数の文字列形式をこのインスタンスの指定した文字位置に挿入します。
Insert(Int32, Int64)	64 ビット符号付き整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。
Insert(Int32, Int32)	指定した 32 ビット符号付き整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。
Insert(Int32, Object)	オブジェクトの文字列形式をこのインスタンスの指定した文字位置に挿入します。
Insert(Int32, Decimal)	10 進数の文字列形式をこのインスタンスの指定した文字位置に挿入します。
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, 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 が、0 未満か、またはこのインスタンスの現在の長さを超えています。

- または -

この StringBuilder オブジェクトの現在の長さに value の長さを加算した結果が、MaxCapacity を超えています。

注釈

既存の文字は、新しいテキストのスペースを作るためにシフトされます。容量は必要に応じて調整されます。

がの場合、または value がではないが長さが 0 の場合nullvalue、のこのインスタンスStringBuilderは変更されませんnull。

こちらもご覧ください

String

適用対象

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 が、0 未満か、またはこのインスタンスの長さを超えています。

OutOfMemoryException

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

Single.ToString はの文字列表現 valueを取得するために使用されます。既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

注意 (呼び出し元)

.NET Framework 3.5 Service Pack 1 以前のバージョンでは、挿入valueするとオブジェクトの全長がを超えるMaxCapacity場合、このメソッドの呼び出しでがスローArgumentOutOfRangeExceptionされました。 .NET Framework 4 以降では、メソッドはをOutOfMemoryExceptionスローします。

こちらもご覧ください

Single

適用対象

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 が、0 未満か、またはこのインスタンスの長さを超えています。

OutOfMemoryException

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

UInt16.ToString はの文字列表現 valueを取得するために使用されます。既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

注意 (呼び出し元)

こちらもご覧ください

UInt16

適用対象

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 が、0 未満か、またはこのインスタンスの長さを超えています。

OutOfMemoryException

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

Int16.ToString はの文字列表現 valueを取得するために使用されます。既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

注意 (呼び出し元)

こちらもご覧ください

Int16

適用対象

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 が、0 未満か、またはこのインスタンスの長さを超えています。

OutOfMemoryException

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

UInt64.ToString はの文字列表現 valueを取得するために使用されます。既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

注意 (呼び出し元)

こちらもご覧ください

UInt64

適用対象

Insert(Int32, String, Int32)

ソース:: StringBuilder.cs

ソース:: StringBuilder.cs

ソース:: StringBuilder.cs

指定した文字列の 1 つ以上のコピーをこのインスタンスの指定した文字位置に挿入します。

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 が、0 未満か、またはこのインスタンスの現在の長さを超えています。

- または -

count が 0 未満です。

OutOfMemoryException

この StringBuilder オブジェクトの現在の長さに value の長さを count 倍した値を加算した結果が、MaxCapacity を超えています。

注釈

既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

がの場合valuenullvalue、このStringBuilderオブジェクトは変更されませんが、null長さが 0 または count 0 です。

こちらもご覧ください

String

適用対象

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 が 0 ではありません。

ArgumentOutOfRangeException

index、startIndex、または charCount が 0 未満です。

- または -

index はこのインスタンスの長さを超えています。

- または -

startIndex に charCount を加算した値が value 内の位置にありません。

- または -

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

適用対象

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 が、0 未満か、またはこのインスタンスの長さを超えています。

OutOfMemoryException

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

SByte.ToString は、の文字列表現 valueを取得するために使用されます。既存の文字は、新しいテキストのスペースを作るためにシフトされます。容量は必要に応じて調整されます。

注意 (呼び出し元)

.NET Framework 3.5 Service Pack 1 以前のバージョンでは、挿入valueするとオブジェクトの全長がを超えるMaxCapacity場合、このメソッドを呼び出すとがスローArgumentOutOfRangeExceptionされました。 .NET Framework 4 以降では、メソッドはをOutOfMemoryExceptionスローします。

こちらもご覧ください

SByte

適用対象

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 が、0 未満か、またはこのインスタンスの長さを超えています。

OutOfMemoryException

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

UInt32.ToString は、の文字列表現 valueを取得するために使用されます。既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

注意 (呼び出し元)

こちらもご覧ください

UInt32

適用対象

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 が挿入できるようにシフトされます。容量は必要に応じて調整されます。

適用対象

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 が、0 未満か、またはこのインスタンスの長さを超えています。

OutOfMemoryException

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

Double.ToString は、の文字列表現 valueを取得するために使用されます。既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

注意 (呼び出し元)

こちらもご覧ください

Double

適用対象

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 が、0 未満か、またはこのインスタンスの長さを超えています。

OutOfMemoryException

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

Int64.ToString は、の文字列表現 valueを取得するために使用されます。既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

注意 (呼び出し元)

こちらもご覧ください

Int64

適用対象

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 が、0 未満か、またはこのインスタンスの長さを超えています。

OutOfMemoryException

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

Int32.ToString は、の文字列表現 valueを取得するために使用されます。既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

注意 (呼び出し元)

こちらもご覧ください

Int32

適用対象

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 が、0 未満か、またはこのインスタンスの長さを超えています。

OutOfMemoryException

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

Object.ToString は、の文字列表現 valueを取得するために使用されます。既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

が nullの場合value、このインスタンスの値は変更されません。

注意 (呼び出し元)

こちらもご覧ください

Object

適用対象

Insert(Int32, Decimal)

ソース:: StringBuilder.cs

ソース:: StringBuilder.cs

ソース:: StringBuilder.cs

10 進数の文字列形式をこのインスタンスの指定した文字位置に挿入します。

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 が、0 未満か、またはこのインスタンスの長さを超えています。

OutOfMemoryException

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

Decimal.ToString はの文字列表現 valueを取得するために使用されます。既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

注意 (呼び出し元)

こちらもご覧ください

Decimal

適用対象

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 が、0 未満か、またはこのインスタンスの長さを超えています。

- または -

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

がのnull場合value、 StringBuilder は変更されません。

適用対象

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 が、0 未満か、またはこのインスタンスの長さを超えています。

- または -

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

Char.ToString はの文字列表現 valueを取得するために使用されます。既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

こちらもご覧ください

Char

適用対象

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 が、0 未満か、またはこのインスタンスの長さを超えています。

OutOfMemoryException

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

Byte.ToString はの文字列表現 valueを取得するために使用されます。既存の文字は、新しいテキストのスペースを作るためにシフトされます。このインスタンスの容量は、必要に応じて調整されます。

注意 (呼び出し元)

こちらもご覧ください

Byte

適用対象

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 が、0 未満か、またはこのインスタンスの長さを超えています。

OutOfMemoryException

このインスタンスの値を増やすと MaxCapacity を超えます。

注釈

Boolean.ToString はの文字列表現 valueを取得するために使用されます。既存の文字は、新しいテキストのスペースを作るためにシフトされます。容量は必要に応じて調整されます。

注意 (呼び出し元)

こちらもご覧ください

Boolean

適用対象