System.String.CopyTo 方法

方法描述

将指定数目的字符从此实例中的指定位置复制到 Unicode 字符数组中的指定位置。

语法定义(C# System.String.CopyTo 方法 的用法)

public void CopyTo(
	int sourceIndex,
	char[] destination,
	int destinationIndex,
	int count
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
sourceIndex System-Int32 要复制的此实例中第一个字符的索引。
destination System-Char[] 此实例中的字符所复制到的 Unicode 字符数组。
destinationIndex System-Int32 destination 中的索引,在此处开始复制操作。
count System-Int32 此实例中要复制到 destination 的字符数。
返回值 void

提示和注释

count 字符从此实例的 sourceIndex 位置复制到 destination 的 destinationIndex 位置。

sourceIndex 和 destinationIndex 是从零开始的。

System.String.CopyTo 方法例子

下面的示例说明 CopyTo 方法。

using System;

public class CopyToTest {
    public static void Main() {

        // Embed an array of characters in a string
        string strSource = "changed";
    char [] destination = { 'T', 'h', 'e', ' ', 'i', 'n', 'i', 't', 'i', 'a', 'l', ' ',
                'a', 'r', 'r', 'a', 'y' };

        // Print the char array
        Console.WriteLine( destination );

        // Embed the source string in the destination string
        strSource.CopyTo ( 0, destination, 4, strSource.Length );

        // Print the resulting array
        Console.WriteLine( destination );

        strSource = "A different string";

        // Embed only a section of the source string in the destination
        strSource.CopyTo ( 2, destination, 3, 9 );

        // Print the resulting array
        Console.WriteLine( destination );
    }
}
// The example displays the following output to the console:
//       The initial array
//       The changed array
//       Thedifferentarray

异常

异常 异常描述
ArgumentNullException destination 为 null。
ArgumentOutOfRangeException
  • sourceIndex、destinationIndex 或 count 为负
  • count 大于从 startIndex 到此实例末尾的子字符串的长度
  • count 大于从 destinationIndex 到 destination 末尾的子数组的长度

命名空间

namespace: System

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.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 系统要求。