信息
您所需的主题如下所示。但此主题未包含在此库中。

StringBuilder.CopyTo 方法

2013/12/13

将此实例的指定段中的字符复制到目标 Char 数组的指定段中。

Namespace:  System.Text
程序集:  mscorlib(位于 mscorlib.dll 中)

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

参数

sourceIndex
类型: System.Int32
此实例中开始复制字符的位置。索引是从零开始的。
destination
类型: System.Char []
将从中复制字符的数组。
destinationIndex
类型: System.Int32
destination 中将从其开始复制字符的起始位置。索引是从零开始的。
count
类型: System.Int32
要复制的字符数。

异常条件
ArgumentNullException

destinationnull

ArgumentOutOfRangeException

sourceIndexdestinationIndexcount,小于零。

- 或 -

sourceIndex 大于此实例的长度。

ArgumentException

sourceIndex + count 大于此实例的长度。

- 或 -

destinationIndex+count 大于 destination 的长度。

CopyTo 方法旨在用于以下极少数的情况:需要将 StringBuilder 对象的连续部分高效地复制到某个数组中。数组应该是大小固定、预分配的、可重用并且可能是全局可访问的。

例如,您的应用程序可能用大量的字符填充 StringBuilder 对象,然后使用 CopyTo 方法将 StringBuilder 对象中较小的连续部分复制到某个数组中,这些部分会在该数组中进行处理。当 StringBuilder 对象中的所有数据都处理完毕后,StringBuilder 对象的大小将被设置为零,并重复上述循环。

下面的示例说明 CopyTo 方法。

Windows Phone OS

受以下版本支持: 8.0

显示: