NameObjectCollectionBase.ICollection.CopyTo(Array, Int32) Methode

Definition

Namespace:

System.Collections.Specialized

Assemblys:

System.dll, System.Collections.Specialized.dll

Assembly:

System.Collections.Specialized.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Kopiert die gesamte NameObjectCollectionBase-Instanz in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays.

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

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

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 NameObjectCollectionBase kopierten Elemente ist. 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 Null.

ArgumentException

array ist mehrdimensional.

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

InvalidCastException

Der Typ der Quell-NameObjectCollectionBase kann nicht automatisch in den Typ des Ziel-array umgewandelt werden.

Hinweise

Das angegebene Array muss ein kompatibler Typ sein.

Diese Methode verwendet Array.Copy , um die Elemente zu kopieren.

Während die Methode standardmäßig nicht für COM-Clients sichtbar ist, kann das Erben der ICollection.CopyTo NameObjectCollectionBase Klasse sie verfügbar machen und unerwünschtes Verhalten in COM-Clients verursachen.

Diese Methode ist ein O()-nVorgang, wo n ist Count.