CodeEvent.Children, propriété

Article
11/15/2012

Obtient une collection d'objets contenus dans CodeEvent.

Espace de noms : EnvDTE80
Assembly : EnvDTE80 (dans EnvDTE80.dll)

Syntaxe

'Déclaration
ReadOnly Property Children As CodeElements

CodeElements Children { get; }

property CodeElements^ Children {
    CodeElements^ get ();
}

abstract Children : CodeElements

function get Children () : CodeElements

Valeur de propriété

Type : EnvDTE.CodeElements
Collection CodeElements.

Notes

Si un objet CodeEvent ne possède pas d'enfant, la valeur Nothing est retournée.

Cette propriété est principalement utilisée par Visual C++.Children retourne chaque objet pouvant être retourné à partir d'un élément de code.Ainsi, une classe retourne des membres, des bases, des interfaces implémentées, des attributs, des commentaires, etc.

Children retourne la collection de tous les objets CodeElement liés qui peuvent être référencés par l'intermédiaire de cet élément de code.Par exemple, pour CodeClass, il peut s'agir des éléments de code de métadonnées de la classe et peut-être des declspec de Visual C++, ainsi que du code contribué basé sur la fonctionnalité Programmation par attributs de Visual C++, de paramètres de modèle, etc.CodeFunction peut comprendre tous ses paramètres, ses paramètres contribués basés sur la fonction Programmation par attributs de Visual C++, etc.

La propriété Children peut retourner la valeur Nothing, selon l'objet et le langage.La prise en charge de cette propriété n'est pas obligatoire dans Visual Studio.

[!REMARQUE]

Les valeurs d'éléments de modèle de code, tels que des classes, des structures, des fonctions, des attributs, des délégués, etc., peuvent être non déterminables après certains types de modifications, ce qui signifie qu'il n'est pas certain que leurs valeurs resteront inchangées.Pour plus d'informations, consultez la section Les valeurs d'élément de modèle de code peuvent être modifiées de la rubrique Découverte de code à l'aide du modèle de code (Visual Basic).

Exemples

L'exemple suivant illustre l'utilisation de la propriété Children.

Pour tester cette propriété :

Ouvrez le projet cible et sélectionnez l'élément d'événement de code en plaçant le curseur sur l'objet événement.
Exécutez le complément.

public static void Children(EnvDTE80.DTE2 dte)
{
    TextSelection objTextSel;
    EnvDTE80.CodeEvent codeEvent;
    objTextSel = (TextSelection)dte.ActiveDocument.Selection;
    codeEvent = (EnvDTE80.CodeEvent)objTextSel.ActivePoint.get_CodeElement(vsCMElement.vsCMElementEvent);

    MessageBox.Show("\nNumber of Children: " +
        codeEvent.Children.Count, "Testing Children Property");
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.