ContextLinkCollection.CopyTo-Methode

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

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

Syntax

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

instance.CopyTo(array, index)

public void CopyTo(
    ContextLink[] array,
    int index
)

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

public void CopyTo(
    ContextLink[] array,
    int index
)

public function CopyTo(
    array : ContextLink[], 
    index : int
)

Parameter

• array
  Typ: array<System.Windows.Ink.ContextLink[]
  Das eindimensionale Array, das das Ziel für aus der Auflistung kopierte 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 ContextLinkCollection durchläuft.

Eine Ausnahme wird in den folgenden Fällen 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 ContextLinkCollection wird automatisch in den Typ des array-Zielparameters 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 [System.Object]. Beim Versuch, in einen anderen Typ von Array zu kopieren, wird eine [System.InvalidCastException] ausgelöst.

Diese Methode ist synchronisiert.

Beispiele

Im folgenden Beispiel wird ein Teil eines Arrays der ContextLink-Objekte mit einer ContextLinkCollection mit dem Namen links aufgefüllt. Es beginnt bei Index 1 (dem zweiten Element in einem nullbasierten Array) des Zielarrays: linkArray. Das erste Element des Zielarrays (mit dem Index 0) wird leer gelassen.

Dim linkArray(theNode.Links.Count + 1) As ContextLink
theNode.Links.CopyTo(linkArray, 1)

ContextLink[] linkArray = new ContextLink[theNode.Links.Count + 1];
theNode.Links.CopyTo(linkArray, 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

ContextLinkCollection-Klasse

ContextLinkCollection-Member

System.Windows.Ink-Namespace