Partager via


ContextNodeCollection.CopyTo, méthode

Mise à jour : November 2007

Copie tous les éléments du ContextNodeCollection actif vers un tableau unidimensionnel donné, à l'aide de l'index du tableau de destination spécifié.

Espace de noms :  System.Windows.Ink
Assembly :  IAWinFX (dans IAWinFX.dll)

Syntaxe

'Déclaration
Public Sub CopyTo ( _
    array As ContextNode(), _
    index As Integer _
)
'Utilisation
Dim instance As ContextNodeCollection
Dim array As ContextNode()
Dim index As Integer

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

Paramètres

  • array
    Type : array<System.Windows.Ink.ContextNode[]
    Tableau unidimensionnel qui reçoit les éléments copiés à partir de la collection. L'indexation de ce tableau doit être de base zéro.
  • index
    Type : System.Int32
    Index de base zéro dans le paramètre array où la copie commence.

Notes

Les éléments sont copiés vers l'objet Array dans le même ordre que l'ordre d'itération de l'énumérateur dans ContextNodeCollection.

Une exception est levée dans les cas suivants :

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

  • 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 Object. La tentative de copie vers un autre type de tableau lève l'exception InvalidCastException.

Exemples

L'exemple suivant remplit une partie d'un tableau d'objets ContextNode avec des paragraphes qu'un InkAnalyzer nommé theInkAnalyzer peut rechercher. Le tableau démarre à l'index 1 (le deuxième élément dans un tableau de base zéro) du tableau de destination, paragraphArray, et laisse le premier élément du tableau de destination, d'index 0, vide.

Dim paragraphs As ContextNodeCollection = theInkAnalyzer.FindNodesOfType(ContextNodeType.Paragraph)
Dim paragraphArray(paragraphs.Count + 1) As ContextNode
paragraphs.CopyTo(paragraphArray, 1)
ContextNodeCollection paragraphs =
    theInkAnalyzer.FindNodesOfType(ContextNodeType.Paragraph);
ContextNode[] paragraphArray = new ContextNode[paragraphs.Count + 1];
paragraphs.CopyTo(paragraphArray, 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

ContextNodeCollection, classe

Membres ContextNodeCollection

System.Windows.Ink, espace de noms