AnalysisAlternateBaseCollection.CopyTo-Methode

Artikel
11/26/2008

Kopiert alle Elemente der aktuellen AnalysisAlternateBaseCollection in das angegebene eindimensionale Array, wobei am angegebenen Index des Zielarrays begonnen wird.

Namespace: System.Windows.Ink.AnalysisCore
Assembly: IACore (in IACore.dll)

Syntax

'Declaration
Public Sub CopyTo ( _
    alternates As AnalysisAlternateBase(), _
    index As Integer _
)
'Usage
Dim instance As AnalysisAlternateBaseCollection
Dim alternates As AnalysisAlternateBase()
Dim index As Integer

instance.CopyTo(alternates, index)

public void CopyTo(
    AnalysisAlternateBase[] alternates,
    int index
)

public:
void CopyTo(
    array<AnalysisAlternateBase^>^ alternates, 
    int index
)

public void CopyTo(
    AnalysisAlternateBase[] alternates,
    int index
)

public function CopyTo(
    alternates : AnalysisAlternateBase[], 
    index : int
)

Parameter

alternates
Typ: array<System.Windows.Ink.AnalysisCore.AnalysisAlternateBase[]
Das eindimensionale Array, das das Ziel der aus der Auflistung kopierten Elemente ist. Das Array muss nullbasierte Indizierung haben.

index
Typ: System.Int32
Der nullbasierte Index im array-Parameter, an dem der Kopiervorgang beginnt.

Hinweise

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

Im folgenden Fall wird eine Ausnahme ausgelöst:

Der array-Parameter ist ein nullNULL-Verweis (Nothing in Visual Basic)-Verweis.
Der index-Parameter ist kleiner als 0 (null).
Der array-Parameter ist mehrdimensional.
Der index-Parameter ist größer oder gleich der Länge des array-Parameters.
Die Anzahl der Elemente in der Auflistung überschreitet den verfügbaren Platz vom index-Parameter bis zum Ende des Ziel-array-Parameters.

Der Typ der Auflistung wird automatisch in den Typ des Ziel-array-Parameters umgewandelt. Mit dieser Methode werden Elemente jedoch nur in Arrays kopiert, die denselben Typ wie die Elemente der Auflistung aufweisen, oder in Arrays vom Typ Object. Beim Versuch, in einen anderen Typ von Array zu kopieren, wird eine InvalidCastException ausgelöst.

Beispiele

Im folgenden Beispiel wird ein Teil eines Arrays der AnalysisAlternateBase-Objekte mit einer AnalysisAlternateBaseCollection mit dem Namen alternates aufgefüllt. Es wird bei Element 1 (dem zweiten Element in einem nullbasierten Array) des Zielarrays alternatesArray begonnen, und das erste Element des Zielarrays (mit dem Index 0) wird leer gelassen.

Dim alternateArray(alternates.Count) As AnalysisAlternateBase
alternates.CopyTo(alternateArray, 1)

            AnalysisAlternateBase[] alternateArray = new AnalysisAlternateBase[alternates.Count + 1];
            alternates.CopyTo(alternateArray, 1);

Plattformen

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

AnalysisAlternateBaseCollection-Klasse

AnalysisAlternateBaseCollection-Member

System.Windows.Ink.AnalysisCore-Namespace

Freigeben über