英語で読む

次の方法で共有


String.Insert(Int32, String) メソッド

定義

このインスタンス内の指定したインデックス位置に指定した文字列を挿入する場合の、新しい文字列を返します。

C#
public string Insert(int startIndex, string value);

パラメーター

startIndex
Int32

挿入の 0 から始まるインデックス位置。

value
String

挿入する文字列。

戻り値

このインスタンスと等価で、value の位置に startIndex が挿入された新しい文字列。

例外

valuenullです。

startIndex が負の数値か、またはこのインスタンスの長さを超えています。

次の使用例は、文字列の 4 番目の文字位置 (インデックス 3 の文字) にスペース文字を挿入します。

C#
using System;

public class Example
{
   public static void Main()
   {
      String original = "aaabbb";
      Console.WriteLine("The original string: '{0}'", original);
      String modified = original.Insert(3, " ");
      Console.WriteLine("The modified string: '{0}'", modified);
   }
}
// The example displays the following output:
//     The original string: 'aaabbb'
//     The modified string: 'aaa bbb'

次のコンソール アプリケーションは、2 匹の動物を記述するために 1 つ以上の形容詞を入力するようにユーザーに求めます。 次に、 メソッドを Insert 呼び出して、ユーザーが入力したテキストを文字列に挿入します。

C#
using System;

public class Example {
    public static void Main()
    {
        string animal1 = "fox";
        string animal2 = "dog";

        string strTarget = String.Format("The {0} jumps over the {1}.",
                                         animal1, animal2);

        Console.WriteLine("The original string is:{0}{1}{0}",
                          Environment.NewLine, strTarget);

        Console.Write("Enter an adjective (or group of adjectives) " +
                      "to describe the {0}: ==> ", animal1);
        string adj1 = Console.ReadLine();

        Console.Write("Enter an adjective (or group of adjectives) " +
                      "to describe the {0}: ==> ", animal2);
        string adj2 = Console.ReadLine();

        adj1 = adj1.Trim() + " ";
        adj2 = adj2.Trim() + " ";

        strTarget = strTarget.Insert(strTarget.IndexOf(animal1), adj1);
        strTarget = strTarget.Insert(strTarget.IndexOf(animal2), adj2);

        Console.WriteLine("{0}The final string is:{0}{1}",
                          Environment.NewLine, strTarget);
    }
}
// Output from the example might appear as follows:
//       The original string is:
//       The fox jumps over the dog.
//
//       Enter an adjective (or group of adjectives) to describe the fox: ==> bold
//       Enter an adjective (or group of adjectives) to describe the dog: ==> lazy
//
//       The final string is:
//       The bold fox jumps over the lazy dog.

注釈

がこのインスタンスの長さと等しい場合 startIndex は、 value このインスタンスの末尾に が追加されます。

注意

このメソッドは、現在のインスタンスの値を変更しません。 代わりに、現在のインスタンスに挿入される value 新しい文字列を返します。

たとえば、 の "abc".Insert(2, "XYZ") 戻り値は "abXYZc" です。

適用対象

製品 バージョン
.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, 10
.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

こちらもご覧ください