System.String.Insert 方法
方法描述
在此实例中的指定索引位置插入一个指定的 String 实例。
语法定义(C# System.String.Insert 方法 的用法)
public string Insert( int startIndex, string value )
参数/返回值
| 参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
|---|---|---|
| startIndex | System-Int32 | 此插入的索引位置。 |
| value | System-String | 要插入的字符串。 |
| 返回值 | System.String | 与此实例等效的一个新字符串，但在该字符串的 startIndex 位置处插入了 value。 |
提示和注释
如果 startIndex 等于此实例的长度，则将 value 追加到此实例的末尾。
注意
此方法不修改当前实例的值。 而是返回一个新字符串，其中 value 已插入到当前实例中。
例如，"abc".Insert(2, "XYZ") 的返回值为“abXYZc”。
System.String.Insert 方法例子
下面的控制台应用程序提供了 Insert 方法的简单使用说明。
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("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 jumped 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 jumped over the lazy dog.
异常
| 异常 | 异常描述 |
|---|---|
| ArgumentNullException | value 为 null。 |
| ArgumentOutOfRangeException | startIndex 为负，或大于此实例的长度。 |
版本信息
.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1 受以下版本支持：
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。