CodeClass2.Children, propriété

Article
05/16/2015

Obtient une collection d'objets contenus dans cette classe de code.

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 with get

function get Children () : CodeElements

Valeur de propriété

Type : CodeElements
Collection CodeElements.

Notes

Si une classe de code ne possède pas d'enfant, la valeur Nothing ou nullune référence null (Nothing en Visual Basic) 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.

Pour itérer au sein des membres d'un espace de noms ou d'un type (classe, struct, interface, etc.), vous devez interroger l'interface (QI) ou effectuer un cast de CodeElement en CodeNamespace, puis utiliser la propriété Members.

Children retourne la collection de tous les objets CodeElement liés qui peuvent être référencés par l'intermédiaire de la classe de code. Par exemple, 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.

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.

Notes

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

[Visual Basic]

Sub ChildrenExample(ByVal dte As DTE2)
    ' Before running this example, open a code document from a project
    ' and place the insertion point inside a namespace definition.
    Try
        ' Retrieve the CodeNamespace at the insertion point.
        Dim sel As TextSelection = _
            CType(dte.ActiveDocument.Selection, TextSelection)
        Dim spc As CodeNamespace = _
            CType(sel.ActivePoint.CodeElement( _
            vsCMElement.vsCMElementNamespace), CodeNamespace)

        ' Find the namespace's children.
        Dim children As String
        Dim elem As CodeElement
        For Each elem In spc.Children
            children &= elem.Name & vbCrLf
        Next

        MsgBox(spc.Name & " has the following child code elements:" & _
            vbCrLf & vbCrLf & children)
    Catch ex As Exception
        MsgBox(ex.Message)
    End Try
End Sub

[C#]

public void ChildrenExample(DTE2 dte)
{
    // Before running this example, open a code document from a project
    // and place the insertion point inside a namespace definition.
    try
    {
        // Retrieve the CodeNamespace at the insertion point.
        TextSelection sel = 
            (TextSelection)dte.ActiveDocument.Selection;
        CodeNamespace spc = 
            (CodeNamespace)sel.ActivePoint.get_CodeElement(
            vsCMElement.vsCMElementNamespace);

        // Find the namespace's children.
        string children = "";
        
        foreach (CodeElement elem in spc.Children)
        children += elem.Name + "\r\n";

        MessageBox.Show(spc.Name + 
            " has the following child code elements:" + "\r\n\r\n" + 
            children);
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

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, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.