CodeEvent.Children-Eigenschaft

Artikel
10/24/2012

Ruft eine Auflistung der Objekte ab, die innerhalb von CodeEvent enthalten sind.

Namespace: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.dll)

Syntax

'Declaration
ReadOnly Property Children As CodeElements

CodeElements Children { get; }

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

abstract Children : CodeElements

function get Children () : CodeElements

Eigenschaftswert

Typ: EnvDTE.CodeElements
Eine CodeElements-Auflistung.

Hinweise

Wenn ein CodeEvent-Objekt keine untergeordneten Elemente aufweist, wird Nothing zurückgegeben.

Diese Eigenschaft wird primär von Visual C++ verwendet.Children gibt jedes Objekt zurück, das von einem Codeelement zurückgegeben werden kann.Eine Klasse gibt z. B. Member, Basen, implementierte Schnittstellen, Attribute, Kommentare usw. zurück.

Children gibt die Auflistung aller zugehörigen CodeElement-Objekte zurück, auf die über dieses Codeelement verwiesen werden kann.Bei einer CodeClass kann dies z. B. Folgendes umfassen: die Metadatencodeelemente für die Klasse und ggf. die Visual C++-declspecs, bereitgestellten Code, der auf dem Feature für die attributierte Programmierung in Visual C++ basiert, sowie Vorlagenparameter usw.CodeFunction kann sämtliche Parameter, bereitgestellte Parameter auf Grundlage des Features Attributierte Programmierung in Visual C++ und anderes mehr enthalten.

Die Children-Eigenschaft gibt, abhängig vom Objekt und der Sprache, Nothing zurück.In Visual Studio ist keine Unterstützung erforderlich.

Hinweis
Die Werte von Codemodellelementen wie Klassen, Strukturen, Funktionen, Attributen, Delegaten usw. können nach bestimmten Bearbeitungsvorgängen nicht deterministisch sein, d. h., dass nicht mehr davon ausgegangen werden kann, dass ihre Werte immer unverändert bleiben.Weitere Informationen finden Sie im Abschnitt zum Änderungsverhalten von Codemodellelementwerten unter Ermitteln von Code über das Codemodell (Visual Basic).

Die Werte von Codemodellelementen wie Klassen, Strukturen, Funktionen, Attributen, Delegaten usw. können nach bestimmten Bearbeitungsvorgängen nicht deterministisch sein, d. h., dass nicht mehr davon ausgegangen werden kann, dass ihre Werte immer unverändert bleiben.Weitere Informationen finden Sie im Abschnitt zum Änderungsverhalten von Codemodellelementwerten unter Ermitteln von Code über das Codemodell (Visual Basic).

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Children-Eigenschaft verwendet wird.

So testen Sie diese Eigenschaft

Öffnen Sie das Zielprojekt, und wählen Sie das Codeereigniselement aus, indem Sie den Cursor auf das Ereignisobjekt setzen.
Führen Sie das Add-In aus.

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");
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.