Partager via


CustomStrokes.CopyTo, méthode

Mise à jour : November 2007

Copie tous les éléments de la collection CustomStrokes active dans un tableau unidimensionnel spécifié, en commençant à l'index de tableau de destination spécifié.

Espace de noms :  Microsoft.Ink
Assembly :  Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Sub CopyTo ( _
    array As Array, _
    index As Integer _
)
'Utilisation
Dim instance As CustomStrokes
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
)

Paramètres

  • array
    Type : System.Array
    Tableau unidimensionnel qui constitue la destination des éléments copiés à partir de la collection. Ce tableau doit avoir une indexation de base zéro.
  • index
    Type : System.Int32
    Index de base zéro dans le paramètre array à partir duquel la copie commence.

Implémentations

ICollection.CopyTo(Array, Int32)

Notes

Les éléments sont copiés dans l'objet System.Array (page pouvant être en anglais) dans le même ordre que l'ordre d'itération de l'énumérateur dans CustomStrokes.

Une exception est levée si :

  • Le paramètre array est une référence nullune référence null (Nothing en Visual Basic) (Nothing en Microsoft® Visual Basic® .NET).

  • Le paramètre index est inférieur à zéro.

  • Le paramètre array est multidimensionnel.

  • Le paramètre index est supérieur ou égal à la longueur du paramètre array.

  • Le nombre d'éléments dans la collection est supérieur à l'espace disponible entre le paramètre index et la fin du paramètre array de destination.

Le type de collection est automatiquement casté en type du paramètre de destination array. Toutefois, cette méthode copie uniquement les éléments vers des tableaux du même type que les éléments de la collection ou des tableaux de type System.Object (page pouvant être en anglais). La tentative de copie vers un autre type de tableau lève une exception System.InvalidCastException (page pouvant être en anglais).

Cette méthode n'est pas synchronisée.

Exemples

Cet exemple C# remplit une partie d'un tableau d'objets Strokes avec l'intégralité du contenu de la collection Ink.CustomStrokes, en commençant par l'élément 1 (le deuxième élément dans un tableau de base zéro) de theCopies du tableau de destination et en laissant le premier élément du tableau de destination (avec un index de 0) vide.

Strokes[] theCopies = new Strokes[theInkCollector.Ink.CustomStrokes.Count + 1];
theInkCollector.Ink.CustomStrokes.CopyTo(theCopies, 1);

Cet exemple Visual Basic® .NET remplit une partie d'un tableau d'objets Strokes avec l'intégralité du contenu de la collection Ink.CustomStrokes, en commençant par l'élément 1 (le deuxième élément dans un tableau de base zéro) de theCopies du tableau de destination et en laissant le premier élément du tableau de destination (avec un index de 0) vide.

Dim theCopies(theInkCollector.Ink.CustomStrokes.Count) As Strokes
theInkCollector.Ink.CustomStrokes.CopyTo(theCopies, 1)

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Informations de version

.NET Framework

Pris en charge dans : 3.0

Voir aussi

Référence

CustomStrokes, classe

Membres CustomStrokes

Microsoft.Ink, espace de noms