CodeAttribute2.Children – vlastnost

Článek
08/11/2011

Získá kolekci objektů obsažených v této konstrukce kódu.

Obor názvů: EnvDTE80
Sestavení: EnvDTE80 (v EnvDTE80.dll)

Syntaxe

'Deklarace
ReadOnly Property Children As CodeElements
    Get

CodeElements Children { get; }

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

abstract Children : CodeElements

function get Children () : CodeElements

Hodnota vlastnosti

Typ: EnvDTE.CodeElements
Vrátí CodeElements kolekce.

Implementuje

CodeAttribute.Children

Poznámky

Pokud objekt nemá žádné podřízené pak Nothing nebo nullodkaz Null (Nothing v jazyce Visual Basic) je vrácena.

Tato vlastnost slouží především Visual C++. Children Vlastnost vrací každý objekt vratných z prvku kódu. Třídy, například vrátí členy, základy, implementovaná rozhraní, atributy, komentáře atd.

Chcete-li iterovat členy obor názvů nebo typ (třída, struktura, rozhraní a podobně) musí dotaz rozhraní (QI) nebo cast CodeElement k objektu CodeNamespace objekt a použijte Members vlastnost.

Children Vlastnost Vrací kolekci všech souvisejících CodeElement2 objekty, které lze odkazovat pomocí tohoto kódu prvku. Například CodeClass2 objekt může obsahovat prvky metadat kód pro třídu a možná Visual C++ declspecs, spolu s přidružených kód založený na funkci připisována programování v jazyce Visual C++, parametry šablony a tak dále. A CodeFunction2 objektu může zahrnovat všechny parametry, přidružených parametrů na základě funkce přidělené programování a tak dále.

Children Vlastnost může vracet Nothing nebo null v závislosti na objektu a jazyk. Není nutné tuto podporu v aplikaci Visual Studio.

Příklady

Následující příklad vytvoří nový obor názvů a atribut aktuální třídy a jsou uvedeny některé vlastnosti atributu.

Sub Children2Example(ByVal dte As DTE2)
    ' Before running this example, open a code page of 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

public void Children2Example(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);
    }
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.