Dictionary<TKey,TValue>.ICollection.CopyTo(Array, Int32) Methode

Definition

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Quelle:

Dictionary.cs

Kopiert die Elemente der ICollection<T> in ein Array, wobei am angegebenen Arrayindex begonnen wird.

 virtual void System.Collections.ICollection.CopyTo(Array ^ array, int index) = System::Collections::ICollection::CopyTo;

void ICollection.CopyTo (Array array, int index);

abstract member System.Collections.ICollection.CopyTo : Array * int -> unit
override this.System.Collections.ICollection.CopyTo : Array * int -> unit

Sub CopyTo (array As Array, index As Integer) Implements ICollection.CopyTo

Parameter

array

Array

Das eindimensionale Array, das das Ziel der aus der ICollection<T> kopierten Elemente darstellt. Für das Array muss eine nullbasierte Indizierung verwendet werden.

index

Int32

Der nullbasierte Index im array, bei dem der Kopiervorgang beginnt.

Implementiert

CopyTo(Array, Int32)

Ausnahmen

ArgumentNullException

array ist null.

ArgumentOutOfRangeException

index ist kleiner als 0.

ArgumentException

array ist mehrdimensional.

- oder -

array verwendet keine nullbasierte Indizierung.

- oder -

Die Anzahl der Elemente in der Quell-ICollection<T> ist größer als der verfügbare Platz vom index bis zum Ende des Ziel-arrays.

- oder -

Der Typ der Quell-ICollection<T> kann nicht automatisch in den Typ des Ziel-array umgewandelt werden.

Hinweise

Jedes aus einem Dictionary<TKey,TValue> kopierte Element ist eine KeyValuePair<TKey,TValue> Struktur, die einen Wert und seinen Schlüssel darstellt.

Hinweis

Wenn der Typ der Quelle ICollection nicht automatisch in den Typ des Ziels arrayumgewandelt werden kann, lösen die nicht generischen Implementierungen von ICollection.CopyTo eine aus InvalidCastException, während die generischen Implementierungen eine ArgumentExceptionauslösen.

Bei dieser Methode handelt es sich um einen O(n)-Vorgang, wobei n ist Count.