导出 (0) 打印
全部展开
此文章由机器翻译。 将光标移到文章的句子上,以查看原文。 更多信息。
译文
原文

String.CopyTo 方法

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

命名空间:  System
程序集:  mscorlib(在 mscorlib.dll 中)

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 的字符数。

异常条件
ArgumentNullException

destinationnull

ArgumentOutOfRangeException

sourceIndexdestinationIndexcount 为负

- 或 -

sourceIndex 无法标识当前实例中的位置。

- 或 -

destinationIndex 没有标识 destination 数组中的有效索引。

- 或 -

count 大于从 startIndex 到此实例末尾的子字符串的长度

- 或 -

count 大于从 destinationIndexdestination 末尾的子数组的长度。

此方法将此实例的 sourceIndex 位置的 count 字符复制到destination 字符数组的 destinationIndex 位置。 此方法不调整 destination 字符数组;它必须具有满足有足够的大小存储复制的字符,否则该方法抛出ArgumentOutOfRangeException

sourceIndexdestinationIndex 是从零开始的。

下面的示例说明 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:
//       The initial array
//       The changed array
//       Thedifferentarray


.NET Framework

受以下版本支持:4.5.2、4.5.1、4.5、4、3.5、3.0、2.0、1.1、1.0

.NET Framework Client Profile

受以下版本支持:4、3.5 SP1

可移植类库

受以下版本支持:可移植类库

适用于 Windows 应用商店应用的 .NET

受以下版本支持:Windows 8

适用于 Windows Phone 应用的 .NET

受以下版本支持:Windows Phone 8、Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(不支持服务器核心角色), Windows Server 2008 R2(支持带 SP1 或更高版本的服务器核心角色;不支持 Itanium)

.NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参阅.NET Framework 系统要求

社区附加资源

添加
Microsoft 正在进行一项网上调查,以了解您对 MSDN 网站的意见。 如果您选择参加,我们将会在您离开 MSDN 网站时向您显示该网上调查。

是否要参加?
显示:
© 2014 Microsoft