Proprietà CodeClass2.Children

Articolo
08/11/2011

Ottiene un insieme di oggetti contenuti in questa classe di codice.

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

Sintassi

'Dichiarazione
ReadOnly Property Children As CodeElements
    Get

CodeElements Children { get; }

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

abstract Children : CodeElements

function get Children () : CodeElements

Valore proprietà

Tipo: EnvDTE.CodeElements
Insieme di CodeElements.

Implementa

CodeClass.Children

Note

Se la classe di codice non dispone di elementi figlio, verrà restituito Nothing o nullriferimento null (Nothing in Visual Basic).

La proprietà è utilizzata principalmente in Visual C++. Children restituisce tutti gli oggetti restituibili da un elemento di codice. Una classe, ad esempio, restituisce membri, basi, interfacce implementate, attributi, commenti e così via.

Per scorrere i membri di uno spazio dei nomi o di un tipo, vale a dire classe, struttura, interfaccia e così via, è necessario eseguire il Query Interface (QI) o il cast di CodeElement a CodeNamespace, quindi utilizzare la proprietà Members.

La proprietà Children restituisce l'insieme di tutti gli oggetti CodeElement correlati a cui è possibile fare riferimento mediante la classe di codice. Possono, ad esempio, essere inclusi gli elementi di codice dei metadati per la classe ed eventualmente le declspec di Visual C++, nonché il codice fornito in base alla funzionalità di programmazione con attributi di Visual C++, i parametri di template e così via.

La proprietà Children può restituire Nothing a seconda dell'oggetto e del linguaggio. In Visual Studio non è previsto un requisito per il supporto.

Nota

I valori degli elementi del modello di codice, quali classi, strutture, funzioni, attributi, delegati e così via, possono non essere deterministici dopo alcuni tipi di modifiche. Ciò significa che non si può fare affidamento sulla stabilità di tali valori. Per ulteriori informazioni, vedere la sezione Possibile modifica dei valori degli elementi del modello di codice in Individuazione di codice mediante il modello di codice (Visual Basic).

Esempi

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

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.