返回以恰当顺序(从第一个元素到最后一个元素)包含列表所有元素的数组;返回数组的运行时类型是指定数组的运行时类型。如果指定数组能容纳列表,则则将该队列返回此处。否则,将分配一个具有指定数组的运行时类型和此列表的大小的新数组。
如果指定的数组能容纳列表,并有剩余的空间(即数组的元素比列表多),那么会将紧接列表尾部的元素设置为 null。(仅 当调用者知道此列表不包含任何 null 元素时,才可使用此方法来确定此列表的长度。)
像 toarray()
方法一样,此方法充当基于数组的 api 与基于 collection 的 api 之间的桥梁。更进一步说,此方法允许对输出数组的运行时类型进行精确控制,在某些情况下,这可以用来节省分配开销。
假定 x 是只包含字符串的一个已知列表。以下代码用来将该列表转储到一个新分配的 string 数组:
string[] y = x.toarray(new string[0]);
注意,toarray(new object[0]) 和 toarray() 在功能上是相同的。
- 指定者:
- 接口
collection
中的 toarray
- 指定者:
- 接口
list
中的 toarray
- 参数:
a
- 要存储列表元素的数组(如果该数组足够大);否则,将分配一个具有相同运行时类型的新数组。
- 返回:
- 包含此列表所有元素的数组
- 抛出:
arraystoreexception
- 如果指定数组的运行时类型不是此列表每个元素的运行时类型的超类型
nullpointerexception
- 如果指定数组为 null