Właściwość CodeAttribute2.Children —

Artykuł
05/17/2015

Pobiera kolekcja obiektów zawartych wewnątrz tej konstrukcji kodu.

Przestrzeń nazw: EnvDTE80
Zestaw: EnvDTE80 (w EnvDTE80.dll)

Składnia

'Deklaracja
ReadOnly Property Children As CodeElements

CodeElements Children { get; }

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

abstract Children : CodeElements with get

function get Children () : CodeElements

Wartość właściwości

Typ: CodeElements
Zwraca CodeElements kolekcji.

Uwagi

Jeśli obiekt nie ma elementów podrzędnych, a następnie Nothing lub nullodwołanie o wartości null (Nothing w języku Visual Basic) jest zwracany.

Ta właściwość jest używana przede wszystkim przez Visual C++.Children Właściwość zwraca każdy obiekt zwrotnych od elementu kodu.Klasy, na przykład zwraca członków, podstawy, implementowane interfejsy, atrybutów, komentarzy i tak dalej.

Aby wykonać iterację członków obszar nazw lub typ (klasy, struktury, interfejs i tak dalej), musisz wykonać kwerendę interfejsu (QI) lub cast CodeElement sprzeciw w stosunku do CodeNamespace obiekt, a następnie użyć Members właściwości.

Children Właściwość zwraca kolekcję wszystkich związanych z CodeElement2 obiektów, które można się odwoływać za pomocą tego elementu kodu.Na przykład, dla CodeClass2 , mogą również zawierać elementy metadanych kodu dla klasy i obiektów może być declspecs Visual C++, wraz z wniesionym kodu w oparciu o przypisane programowania funkcji w programie Visual C++, parametry szablonu i tak dalej.A CodeFunction2 obiektu może zawierać wszystkie jego parametry, parametry wniesionym na podstawie przypisane programowania funkcji i tak dalej.

Children Właściwość może zwracać Nothing lub null w zależności od obiektu i języka.Nie istnieje wymóg na poparcie tego w programie Visual Studio.

Przykłady

Poniższy przykład tworzy nowy obszar nazw i atrybut w bieżącej klasy i zawiera listę niektórych właściwości atrybutu.

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

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.