String.Insert メソッド

.NET Framework クラス ライブラリ リファレンス

String.Insert メソッド

このインスタンス内の指定したインデックス位置に、指定した String インスタンスを挿入します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Function Insert ( _
    startIndex As Integer, _
    value As String _
) As String

Visual Basic (使用法)

Dim instance As String
Dim startIndex As Integer
Dim value As String
Dim returnValue As String

returnValue = instance.Insert(startIndex, value)

C#

public string Insert (
    int startIndex,
    string value
)

C++

public:
String^ Insert (
    int startIndex, 
    String^ value
)

J#

public String Insert (
    int startIndex, 
    String value
)

JScript

public function Insert (
    startIndex : int, 
    value : String
) : String

パラメータ

startIndex

挿入先インデックス位置。

value

挿入する String。

戻り値
このインスタンスと等価で、startIndex の位置に value が挿入された新しい String。

例外

例外の種類	条件
ArgumentNullException	value が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	startIndex が負か、またはこのインスタンスの長さより大きい値です。

解説

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

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

使用例

Insert メソッドの簡単な例を次のコンソール アプリケーションで示します。

Visual Basic

Imports System

Public Class InsertTest
    
    Public Shared Sub Main()
        Dim animal1 As String
 = "fox"
        Dim animal2 As String
 = "dog"
        Dim strTarget As String
 = [String].Format("The {0} jumped over the {1}.",
 animal1, animal2)
        
        Console.WriteLine("The original string is:{0}{1}{0}",
 Environment.NewLine, strTarget)
        
        Console.Write("Please enter an adjective (or a group of
 adjectives) to describe the {0}: ==> ", animal1)
        Dim adj1 As String
 = Console.ReadLine()
        
        Console.Write("Please enter an adjective (or a group of
 adjectives) to describe the {0}: ==> ", animal2)
        Dim adj2 As String
 = 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)
    End Sub 'Main
End Class 'InsertTest

C#

using System;

public class InsertTest {
    public static void Main()
 {

        string animal1 = "fox";
        string animal2 = "dog";

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

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

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

        Console.Write("Please enter an adjective (or a 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);
    }
}

C++

using namespace System;
int main()
{
   String^ animal1 = "fox";
   String^ animal2 = "dog";
   String^ strTarget = String::Format( "The {0} jumped over the {1}.",
 animal1, animal2 );
   Console::WriteLine( "The original string is:{0}{1}{0}",
 Environment::NewLine, strTarget );
   Console::Write( "Please enter an adjective (or a group of adjectives) to
 describe the {0}: ==> ", animal1 );
   String^ adj1 = Console::ReadLine();
   Console::Write( "Please enter an adjective (or a group of adjectives) to
 describe the {0}: ==> ", animal2 );
   String^ adj2 = Console::ReadLine();
   adj1 = String::Concat( adj1->Trim(), " " );
   adj2 = String::Concat( 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 );
}

J#

import System.*;

public class InsertTest
{
    public static void main(String[]
 args)
    {
        String animal1 = "fox";
        String animal2 = "dog";

        String strTarget = String.Format("The {0} jumped over the {1}.",
 
            animal1, animal2);
        Console.WriteLine("The original string is:{0}{1}{0}",
 
            Environment.get_NewLine(), strTarget);
        Console.Write("Please enter an adjective (or a group of adjectives)
 "
            + "to describe the {0}: ==> ", animal1);
        String adj1 = Console.ReadLine();

        Console.Write("Please enter an adjective (or a 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.get_NewLine(), strTarget);
    } //main
} //InsertTest

JScript

import System;

public class InsertTest {
    public static function
 Main() : void {

        var animal1 : String = "fox";
        var animal2 : String = "dog";

        var strTarget : String = String.Format("The {0} jumped
 over the {1}.", animal1, animal2);

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

        Console.Write("Please enter an adjective (or a group of adjectives)
 to describe the {0}: ==> ", animal1);
        var adj1 : String = Console.ReadLine();

        Console.Write("Please enter an adjective (or a group of adjectives)
 to describe the {0}: ==> ", animal2);    
        var adj2 : String = 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);
    }
}
InsertTest.Main();

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
String クラス
String メンバ
System 名前空間
Int32 構造体
Concat
CopyTo
Insert
Join
Remove
Replace
Split
Substring
Trim