DictionaryBase.CopyTo-Methode

Artikel
08/20/2007

Kopiert die DictionaryBase-Elemente am angegebenen Index in ein eindimensionales Array.

Namespace: System.Collections
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Sub CopyTo ( _
    array As Array, _
    index As Integer _
)
'Usage
Dim instance As DictionaryBase
Dim array As Array
Dim index As Integer

instance.CopyTo(array, index)

public void CopyTo (
    Array array,
    int index
)

public:
virtual void CopyTo (
    Array^ array, 
    int index
) sealed

public final void CopyTo (
    Array array, 
    int index
)

public final function CopyTo (
    array : Array, 
    index : int
)

Parameter

array
Das eindimensionale Array, in das die DictionaryEntry-Objekte aus der DictionaryBase-Instanz kopiert werden. Für Array muss eine nullbasierte Indizierung verwendet werden.

index
Der nullbasierte Index in array, ab dem kopiert wird.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	array ist NULL (Nothing in Visual Basic).
ArgumentOutOfRangeException	index ist kleiner als 0.
ArgumentException	array ist mehrdimensional. - oder - index ist größer oder gleich der Länge von array. – oder – Die Anzahl der aus der Quell-DictionaryBase zu kopierenden Elemente ist größer als der verfügbare Platz von index bis zum Ende des Ziel-array.
InvalidCastException	Der Typ der Quell-DictionaryBase kann nicht automatisch in den Typ des Ziel-array umgewandelt werden.

Hinweise

Die Elemente werden in derselben Reihenfolge nach Array kopiert, in der der Enumerator DictionaryBase durchläuft.

Diese Methode ist eine O(n)-Operation, wobei n der Count ist.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

DictionaryBase-Klasse
DictionaryBase-Member
System.Collections-Namespace
Array-Klasse
DictionaryEntry
GetEnumerator

Freigeben über