Freigeben über


AnalysisAlternateCollection.CopyTo-Methode

Kopiert alle Elemente der aktuellen AnalysisAlternateCollection in ein eindimensionales Array, wobei am angegebenen Index des Zielarrays begonnen wird.

Namespace:  System.Windows.Ink
Assembly:  IAWinFX (in IAWinFX.dll)

Syntax

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

instance.CopyTo(alternates, index)
public void CopyTo(
    AnalysisAlternate[] alternates,
    int index
)
public:
void CopyTo(
    array<AnalysisAlternate^>^ alternates, 
    int index
)
public void CopyTo(
    AnalysisAlternate[] alternates,
    int index
)
public function CopyTo(
    alternates : AnalysisAlternate[], 
    index : int
)

Parameter

  • alternates
    Typ: array<System.Windows.Ink.AnalysisAlternate[]
    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 in das Array-Objekt kopiert, in der der Enumerator die AnalysisAlternateCollection 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. Diese Methode kopiert Elemente in Arrays nur von den Typen AnalysisAlternate oder Object. Beim Versuch, in einen anderen Typ von Array zu kopieren, wird eine InvalidCastException-Ausnahme ausgelöst.

Beispiele

In diesem Beispiel wird ein Teil eines Arrays der AnalysisAlternate-Objekte mit einer AnalysisAlternateCollection namens alternates aufgefüllt. Das Array beginnt bei Index 1 (dem zweiten Element in einem nullbasierten Array) des Zielarrays alternateArray,. Das erste Element des Zielarrays (mit dem Index 0) wird leer gelassen.

Dim alternateArray(alternates.Count + 1) As AnalysisAlternate
alternates.CopyTo(alternateArray, 1)
AnalysisAlternate[] alternateArray = new AnalysisAlternate[alternates.Count + 1];
alternates.CopyTo(alternateArray, 1);

Plattformen

Windows Vista

.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

AnalysisAlternateCollection-Klasse

AnalysisAlternateCollection-Member

System.Windows.Ink-Namespace