Hashtable.CopyTo(Array, Int32) 메서드

정의

네임스페이스:
System.Collections
어셈블리:
mscorlib.dll, System.Collections.NonGeneric.dll
어셈블리:
netstandard.dll, System.Runtime.dll
어셈블리:
System.Collections.NonGeneric.dll
어셈블리:
System.Runtime.Extensions.dll
어셈블리:
mscorlib.dll
어셈블리:
netstandard.dll
Source:
Hashtable.cs
Source:
Hashtable.cs
Source:
Hashtable.cs
Source:
Hashtable.cs
Source:
Hashtable.cs

지정된 인덱스의 Hashtable 1차원 Array 인스턴스에 요소를 복사합니다.

public:
 virtual void CopyTo(Array ^ array, int arrayIndex);
public virtual void CopyTo(Array array, int arrayIndex);
abstract member CopyTo : Array * int -> unit
override this.CopyTo : Array * int -> unit
Public Overridable Sub CopyTo (array As Array, arrayIndex As Integer)

매개 변수

array
Array

에서 복사Array한 개체의 대상인 DictionaryEntry 1차원 Hashtable 입니다. Array 0부터 시작하는 인덱싱이 있어야 합니다.

arrayIndex
Int32

복사가 시작되는 인덱 array 스(0부터 시작)입니다.

구현

CopyTo(Array, Int32)

예외

ArgumentNullException

array은 null입니다.

ArgumentOutOfRangeException

arrayIndex가 0보다 작습니다.

ArgumentException

array 가 다차원입니다.

-또는-

원본 Hashtable 의 요소 수가 대상arrayIndex의 끝까지 사용 가능한 공간 array 보다 큽합니다.

InvalidCastException

원본 Hashtable 의 형식을 대상 array의 형식으로 자동으로 캐스팅할 수 없습니다.

예제

다음 예제에서는 키 목록 또는 값 목록을 1 Hashtable 차원으로 복사하는 방법을 보여 있습니다 Array.

using System;
using System.Collections;
public class SamplesHashtable
{

   public static void Main()
   {
      // Creates and initializes the source Hashtable.
      var mySourceHT = new Hashtable();
      mySourceHT.Add("A", "valueA");
      mySourceHT.Add("B", "valueB");

      // Creates and initializes the one-dimensional target Array.
      var myTargetArray = new String[15];
      myTargetArray[0] = "The";
      myTargetArray[1] = "quick";
      myTargetArray[2] = "brown";
      myTargetArray[3] = "fox";
      myTargetArray[4] = "jumps";
      myTargetArray[5] = "over";
      myTargetArray[6] = "the";
      myTargetArray[7] = "lazy";
      myTargetArray[8] = "dog";

      // Displays the values of the target Array.
      Console.WriteLine("The target Array contains the following before:");
      PrintValues(myTargetArray, ' ');

      // Copies the keys in the source Hashtable to the target Hashtable, starting at index 6.
      Console.WriteLine("After copying the keys, starting at index 6:");
      mySourceHT.Keys.CopyTo(myTargetArray, 6);

      // Displays the values of the target Array.
      PrintValues(myTargetArray, ' ');

      // Copies the values in the source Hashtable to the target Hashtable, starting at index 6.
      Console.WriteLine("After copying the values, starting at index 6:");
      mySourceHT.Values.CopyTo(myTargetArray, 6);

      // Displays the values of the target Array.
      PrintValues(myTargetArray, ' ');
   }

   public static void PrintValues(String[] myArr, char mySeparator)
   {
      for (int i = 0; i < myArr.Length; i++)
         Console.Write($"{mySeparator}{myArr[i]}");
      Console.WriteLine();
   }
}
/*
This code produces the following output.

The target Array contains the following before:
 The quick brown fox jumps over the lazy dog
After copying the keys, starting at index 6:
 The quick brown fox jumps over B A dog
After copying the values, starting at index 6:
 The quick brown fox jumps over valueB valueA dog

*/

Imports System.Collections

Public Class SamplesHashtable

    Public Shared Sub Main()

        ' Creates and initializes the source Hashtable.
        Dim mySourceHT As New Hashtable()
        mySourceHT.Add("A", "valueA")
        mySourceHT.Add("B", "valueB")

        ' Creates and initializes the one-dimensional target Array.
        Dim myTargetArray(14) As String
        myTargetArray(0) = "The"
        myTargetArray(1) = "quick"
        myTargetArray(2) = "brown"
        myTargetArray(3) = "fox"
        myTargetArray(4) = "jumps"
        myTargetArray(5) = "over"
        myTargetArray(6) = "the"
        myTargetArray(7) = "lazy"
        myTargetArray(8) = "dog"

        ' Displays the values of the target Array.
        Console.WriteLine("The target Array contains the following before:")
        PrintValues(myTargetArray, " "c)

        ' Copies the keys in the source Hashtable to the target Hashtable, starting at index 6.
        Console.WriteLine("After copying the keys, starting at index 6:")
        mySourceHT.Keys.CopyTo(myTargetArray, 6)

        ' Displays the values of the target Array.
        PrintValues(myTargetArray, " "c)

        ' Copies the values in the source Hashtable to the target Hashtable, starting at index 6.
        Console.WriteLine("After copying the values, starting at index 6:")
        mySourceHT.Values.CopyTo(myTargetArray, 6)

        ' Displays the values of the target Array.
        PrintValues(myTargetArray, " "c)

    End Sub

    Public Shared Sub PrintValues(myArr As String(), mySeparator As Char)
        For i As Integer = 0 To myArr.Length - 1
            Console.Write($"{mySeparator}{myArr(i)}")
        Next i
        Console.WriteLine()
    End Sub

End Class


' This code produces the following output.
' 
' The target Array contains the following before:
'  The quick brown fox jumps over the lazy dog
' After copying the keys, starting at index 6:
'  The quick brown fox jumps over A B dog
' After copying the values, starting at index 6:
'  The quick brown fox jumps over valueA valueB dog

설명

요소는 열거자가 반복하는 순서와 동일한 순서로 복사 Array 됩니다 Hashtable.

에서 키만 복사하려면 .를 Hashtable사용합니다 Hashtable.Keys.CopyTo.

의 값만 복사하려면 .를 Hashtable사용합니다 Hashtable.Values.CopyTo.

이 메서드는 O(n) 작업입니다 nCount.

적용 대상

추가 정보