英語で読む

次の方法で共有


StringBuilder.Insert メソッド

定義

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

オーバーロード

Insert(Int32, SByte)

指定した 8 ビット符号付き整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。

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

Unicode 文字の指定した部分配列の文字列形式をこのインスタンスの指定した文字位置に挿入します。

Insert(Int32, String, Int32)

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

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)

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

Insert(Int32, Char[])

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

Insert(Int32, Char)

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

Insert(Int32, Byte)

指定した 8 ビット符号なし整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。

Insert(Int32, Boolean)

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

Insertメソッドの例を次に示します。

C#
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]--

*/

Insert(Int32, SByte)

ソース:
StringBuilder.cs
ソース:
StringBuilder.cs
ソース:
StringBuilder.cs

重要

この API は CLS 準拠ではありません。

指定した 8 ビット符号付き整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。

C#
[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert (int index, sbyte value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
SByte

挿入する値。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

属性

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

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

注釈

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

.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 文字の指定した部分配列の文字列形式をこのインスタンスの指定した文字位置に挿入します。

C#
public System.Text.StringBuilder Insert (int index, char[] value, int startIndex, int charCount);
C#
public System.Text.StringBuilder Insert (int index, char[]? value, int startIndex, int charCount);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
Char[]

文字配列。

startIndex
Int32

value 内の開始インデックス。

charCount
Int32

挿入する文字数。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

例外

valuenull で、startIndexcharCount が 0 ではありません。

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

- または -

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

- または -

startIndexcharCount を加算した値が 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

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

C#
public System.Text.StringBuilder Insert (int index, string value, int count);
C#
public System.Text.StringBuilder Insert (int index, string? value, int count);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
String

挿入する文字列。

count
Int32

value を挿入する回数。

戻り値

挿入が完了した後のこのインスタンスへの参照。

例外

index が、0 未満か、またはこのインスタンスの現在の長さを超えています。

- または -

count が 0 未満です。

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

注釈

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

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

こちらもご覧ください

適用対象

.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 ビット符号なし整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。

C#
[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert (int index, ulong value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
UInt64

挿入する値。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

属性

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

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

注釈

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

.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 ビット符号なし整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。

C#
[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert (int index, uint value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
UInt32

挿入する値。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

属性

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

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

注釈

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

.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 ビット符号なし整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。

C#
[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert (int index, ushort value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
UInt16

挿入する値。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

属性

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

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

注釈

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

.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

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

C#
public System.Text.StringBuilder Insert (int index, string value);
C#
public System.Text.StringBuilder Insert (int index, string? value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
String

挿入する文字列。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

例外

index が、0 未満か、またはこのインスタンスの現在の長さを超えています。

- または -

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

注釈

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

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

こちらもご覧ください

適用対象

.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

単精度浮動小数点数の文字列形式をこのインスタンスの指定した文字位置に挿入します。

C#
public System.Text.StringBuilder Insert (int index, float value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
Single

挿入する値。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

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

注釈

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

.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

文字のシーケンスをこのインスタンスの指定した文字位置に挿入します。

C#
public System.Text.StringBuilder Insert (int index, ReadOnlySpan<char> value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
ReadOnlySpan<Char>

挿入する文字スパン。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

注釈

既存の文字は、 内の文字シーケンス 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 ビット符号付き整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。

C#
public System.Text.StringBuilder Insert (int index, short value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
Int16

挿入する値。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

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

注釈

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

.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 ビット符号付き整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。

C#
public System.Text.StringBuilder Insert (int index, long value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
Int64

挿入する値。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

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

注釈

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

.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 ビット符号付き整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。

C#
public System.Text.StringBuilder Insert (int index, int value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
Int32

挿入する値。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

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

注釈

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

.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

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

C#
public System.Text.StringBuilder Insert (int index, object value);
C#
public System.Text.StringBuilder Insert (int index, object? value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
Object

挿入するオブジェクト、または null

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

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

注釈

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

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

.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

倍精度浮動小数点数の文字列形式をこのインスタンスの指定した文字位置に挿入します。

C#
public System.Text.StringBuilder Insert (int index, double value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
Double

挿入する値。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

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

注釈

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

.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

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

C#
public System.Text.StringBuilder Insert (int index, decimal value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
Decimal

挿入する値。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

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

注釈

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

.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 文字の配列の文字列形式をこのインスタンスの指定した文字位置に挿入します。

C#
public System.Text.StringBuilder Insert (int index, char[] value);
C#
public System.Text.StringBuilder Insert (int index, char[]? value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
Char[]

挿入する文字配列。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

- または -

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

注釈

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

が のnull場合valueStringBuilder は変更されません。

適用対象

.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 文字の文字列形式をこのインスタンスの指定した文字位置に挿入します。

C#
public System.Text.StringBuilder Insert (int index, char value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
Char

挿入する値。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

- または -

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

注釈

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

こちらもご覧ください

適用対象

.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 ビット符号なし整数の文字列形式をこのインスタンスの指定した文字位置に挿入します。

C#
public System.Text.StringBuilder Insert (int index, byte value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
Byte

挿入する値。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

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

注釈

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

.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 値の文字列形式をこのインスタンスの指定した文字位置に挿入します。

C#
public System.Text.StringBuilder Insert (int index, bool value);

パラメーター

index
Int32

このインスタンスにおける挿入の開始位置。

value
Boolean

挿入する値。

戻り値

挿入操作が完了した後のこのインスタンスへの参照。

例外

index が、0 未満か、またはこのインスタンスの長さを超えています。

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

注釈

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

注意 (呼び出し元)

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

こちらもご覧ください

適用対象

.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