StringDictionary.CopyTo(Array, Int32) Metod

Definition

Namnområde:
System.Collections.Specialized
Sammansättningar:
System.dll, System.Collections.Specialized.dll
Sammansättningar:
netstandard.dll, System.Collections.Specialized.dll
Sammansättning:
System.Collections.Specialized.dll
Sammansättning:
System.dll
Sammansättning:
netstandard.dll
Källa:
StringDictionary.cs
Källa:
StringDictionary.cs
Källa:
StringDictionary.cs
Källa:
StringDictionary.cs
Källa:
StringDictionary.cs

Kopierar strängordlistevärdena till en endimensionell Array instans vid det angivna indexet.

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

Parametrar

array
Array

Den endimensionella Array som är målet för de värden som kopieras från StringDictionary.

index
Int32

Indexet i matrisen där kopieringen börjar.

Undantag

ArgumentException

array är flerdimensionellt.

-eller-

Antalet element i StringDictionary är större än det tillgängliga utrymmet från index till slutet av array.

ArgumentNullException

array är null.

ArgumentOutOfRangeException

index är mindre än den nedre gränsen för array.

Exempel

I följande kodexempel visas hur en StringDictionary kan kopieras till en matris.

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

public class SamplesStringDictionary  {

   public static void Main()  {

      // Creates and initializes a new StringDictionary.
      StringDictionary myCol = new StringDictionary();
      myCol.Add( "red", "rojo" );
      myCol.Add( "green", "verde" );
      myCol.Add( "blue", "azul" );

      // Displays the values in the StringDictionary.
      Console.WriteLine( "KEYS\tVALUES in the StringDictionary" );
      foreach ( DictionaryEntry myDE in myCol )
         Console.WriteLine( "{0}\t{1}", myDE.Key, myDE.Value );
      Console.WriteLine();

      // Creates an array with DictionaryEntry elements.
      DictionaryEntry[] myArr = { new DictionaryEntry(), new DictionaryEntry(), new DictionaryEntry() };

      // Copies the StringDictionary to the array.
      myCol.CopyTo( myArr, 0 );

      // Displays the values in the array.
      Console.WriteLine( "KEYS\tVALUES in the array" );
      for ( int i = 0; i < myArr.Length; i++ )
         Console.WriteLine( "{0}\t{1}", myArr[i].Key, myArr[i].Value );
      Console.WriteLine();
   }
}

/*
This code produces the following output.

KEYS    VALUES in the StringDictionary
green   verde
red     rojo
blue    azul

KEYS    VALUES in the array
green   verde
red     rojo
blue    azul

*/

Imports System.Collections
Imports System.Collections.Specialized

Public Class SamplesStringDictionary

   Public Shared Sub Main()

      ' Creates and initializes a new StringDictionary.
      Dim myCol As New StringDictionary()
      myCol.Add("red", "rojo")
      myCol.Add("green", "verde")
      myCol.Add("blue", "azul")

      ' Displays the values in the StringDictionary.
      Console.WriteLine("KEYS" + ControlChars.Tab + "VALUES in the StringDictionary")
      Dim myDE As DictionaryEntry
      For Each myDE In  myCol
         Console.WriteLine("{0}" + ControlChars.Tab + "{1}", myDE.Key, myDE.Value)
      Next myDE
      Console.WriteLine()

      ' Creates an array with DictionaryEntry elements.
      Dim myArr As DictionaryEntry() =  {New DictionaryEntry(), New DictionaryEntry(), New DictionaryEntry()}

      ' Copies the StringDictionary to the array.
      myCol.CopyTo(myArr, 0)

      ' Displays the values in the array.
      Console.WriteLine("KEYS" + ControlChars.Tab + "VALUES in the array")
      Dim i As Integer
      For i = 0 To myArr.Length - 1
         Console.WriteLine("{0}" + ControlChars.Tab + "{1}", myArr(i).Key, myArr(i).Value)
      Next i
      Console.WriteLine()

   End Sub

End Class


'This code produces the following output.
'
'KEYS    VALUES in the StringDictionary
'green   verde
'red     rojo
'blue    azul
'
'KEYS    VALUES in the array
'green   verde
'red     rojo
'blue    azul

Kommentarer

CopyTo kopierar objekt som kan skrivas till System.Collections.DictionaryEntry. DictionaryEntry innehåller både nyckeln och värdet.

Elementen som kopieras till Array sorteras i samma ordning som uppräkningsverktyget itererar via StringDictionary.

Den här metoden är en O()-nåtgärd, där n är Count.

Gäller för