Proprietà CodeAttribute2.Children

Articolo
10/30/2012

Ottiene una raccolta di oggetti contenuto nel costrutto di codice.

Spazio dei nomi: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.dll)

Sintassi

'Dichiarazione
ReadOnly Property Children As CodeElements

CodeElements Children { get; }

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

abstract Children : CodeElements

function get Children () : CodeElements

Valore proprietà

Tipo: EnvDTE.CodeElements
Restituisce un oggetto CodeElements raccolta.

Note

Se un oggetto non ha figli, quindi Nothing o nullriferimento null (Nothing in Visual Basic) viene restituito.

Questa proprietà viene utilizzata principalmente da Visual C++.Children la proprietà restituisce ogni oggetto restituibile da un elemento di codice.La classe, ad esempio, restituisce i membri, basi, interfacce implementate, attributi, commenti, e così via.

Per scorrere i membri di uno spazio dei nomi o di un tipo (classe, struttura, interfaccia, e così via), è necessario eseguire una query l'interfaccia (QI) o eseguire il cast CodeElement oggetto su un oggetto CodeNamespace oggetto e quindi utilizzare Members proprietà.

Children la proprietà restituisce la raccolta di qualsiasi correlato CodeElement2 oggetti che possono farvi riferimento dall'elemento di codice.Ad esempio, per un oggetto CodeClass2 oggetto, questo potrebbe includere gli elementi di codice di metadati per la classe ed eventualmente i declspec di Visual C++, con il codice fornito in base alla funzionalità di programmazione con attributi in Visual C++, parametri di modello, e così via.In CodeFunction2 l'oggetto può includere tutti i relativi parametri, parametri forniti in base alla funzionalità di programmazione con attributi, e così via.

Children la proprietà può restituire Nothing o nullriferimento null (Nothing in Visual Basic)a seconda dell'oggetto e il linguaggio.Non esiste un requisito supportare questo in Visual Studio.

Esempi

Nell'esempio seguente viene creato un nuovo spazio dei nomi e l'attributo nella classe corrente e vengono elencate alcune delle proprietà dell'attributo.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.