StringCollection.CopyTo(String[], Int32) 方法

定义

命名空间:
System.Collections.Specialized
程序集:
System.dll, System.Collections.Specialized.dll
程序集:
netstandard.dll, System.Collections.Specialized.dll
程序集:
System.Collections.Specialized.dll
程序集:
System.dll
程序集:
netstandard.dll
Source:
StringCollection.cs
Source:
StringCollection.cs
Source:
StringCollection.cs
Source:
StringCollection.cs
Source:
StringCollection.cs

从目标数组的指定索引处开始，将整个 StringCollection 值复制到字符串的一维数组。

public:
 void CopyTo(cli::array <System::String ^> ^ array, int index);
public void CopyTo(string[] array, int index);
public void CopyTo(string?[] array, int index);
member this.CopyTo : string[] * int -> unit
Public Sub CopyTo (array As String(), index As Integer)

参数

array
String[]

字符串的一维数组，它是从中 StringCollection复制的元素的目标。 必须 Array 具有从零开始的索引。

index
Int32

从零开始复制的索引 array 。

例外

ArgumentNullException

array 是 null。

ArgumentOutOfRangeException

index 小于零。

ArgumentException

array 是多维。

-或-

源StringCollection中的元素数大于目标indexarray末尾的可用空间。

InvalidCastException

源 StringCollection 的类型不能自动转换为目标 array的类型。

示例

下面的代码示例将 a StringCollection 复制到数组。

using System;
using System.Collections;
using System.Collections.Specialized;

public class SamplesStringCollection  {

   public static void Main()  {

      // Creates and initializes a new StringCollection.
      StringCollection myCol = new StringCollection();
      String[] myArr = new String[] { "RED", "orange", "yellow", "RED", "green", "blue", "RED", "indigo", "violet", "RED" };
      myCol.AddRange( myArr );

      Console.WriteLine( "Initial contents of the StringCollection:" );
      PrintValues( myCol );

      // Copies the collection to a new array starting at index 0.
      String[] myArr2 = new String[myCol.Count];
      myCol.CopyTo( myArr2, 0 );

      Console.WriteLine( "The new array contains:" );
      for ( int i = 0; i < myArr2.Length; i++ )  {
         Console.WriteLine( "   [{0}] {1}", i, myArr2[i] );
      }
      Console.WriteLine();
   }

   public static void PrintValues( IEnumerable myCol )  {
      foreach ( Object obj in myCol )
         Console.WriteLine( "   {0}", obj );
      Console.WriteLine();
   }
}

/*
This code produces the following output.

Initial contents of the StringCollection:
   RED
   orange
   yellow
   RED
   green
   blue
   RED
   indigo
   violet
   RED

The new array contains:
   [0] RED
   [1] orange
   [2] yellow
   [3] RED
   [4] green
   [5] blue
   [6] RED
   [7] indigo
   [8] violet
   [9] RED

*/

Imports System.Collections
Imports System.Collections.Specialized

Public Class SamplesStringCollection   

   Public Shared Sub Main()

      ' Creates and initializes a new StringCollection.
      Dim myCol As New StringCollection()
      Dim myArr() As [String] = {"RED", "orange", "yellow", "RED", "green", "blue", "RED", "indigo", "violet", "RED"}
      myCol.AddRange(myArr)

      Console.WriteLine("Initial contents of the StringCollection:")
      PrintValues(myCol)

      ' Copies the collection to a new array starting at index 0.
      Dim myArr2(myCol.Count) As [String]
      myCol.CopyTo(myArr2, 0)

      Console.WriteLine("The new array contains:")
      Dim i As Integer
      For i = 0 To myArr2.Length - 1
         Console.WriteLine("   [{0}] {1}", i, myArr2(i))
      Next i
      Console.WriteLine()

   End Sub

   Public Shared Sub PrintValues(myCol As IEnumerable)
      Dim obj As [Object]
      For Each obj In  myCol
         Console.WriteLine("   {0}", obj)
      Next obj
      Console.WriteLine()
   End Sub

End Class


'This code produces the following output.
'
'Initial contents of the StringCollection:
'   RED
'   orange
'   yellow
'   RED
'   green
'   blue
'   RED
'   indigo
'   violet
'   RED
'
'The new array contains:
'   [0] RED
'   [1] orange
'   [2] yellow
'   [3] RED
'   [4] green
'   [5] blue
'   [6] RED
'   [7] indigo
'   [8] violet
'   [9] RED
'

注解

指定的数组必须是兼容的类型。

元素的复制Array顺序与循环StringCollection访问的枚举器StringCollection的顺序相同。

此方法是 O（n） 操作，其中 n 。Count

适用于

另请参阅