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

Definition

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

Ausnahmen

array ist null.

index ist kleiner als 0.

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.

Gilt für: