Propriedade CodeAttribute2.Children

Artigo
08/01/2011

Obtém uma coleção de objetos contida nesta construção de código.

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

Sintaxe

'Declaração
ReadOnly Property Children As CodeElements
    Get

CodeElements Children { get; }

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

abstract Children : CodeElements

function get Children () : CodeElements

Valor de propriedade

Tipo: EnvDTE.CodeElements
Retorna um CodeElements coleção.

Implementações

CodeAttribute.Children

Comentários

Se um objeto não tem filhos, em seguida, Nothing ou nulluma referência nula (Nothing no Visual Basic) é retornado.

Esta propriedade é usada principalmente pelo Visual C++. O Children propriedade retorna a cada objeto retornável a partir de um elemento de código. Uma classe, por exemplo, retorna os membros, bases, interfaces implementadas, atributos, comentários e assim por diante.

Percorrer os membros de um namespace ou tipo (classe, struct, interface e assim por diante), consultar interface (QI) ou cast a CodeElement o objeto para um CodeNamespace de objeto e use o Members propriedade.

O Children propriedade retorna a coleção de todos os relacionados CodeElement2 os objetos que podem ser referenciados por meio deste elemento de código. Por exemplo, para um CodeClass2 o objeto, isso pode incluir os elementos de código de metadados para a classe e talvez o declspecs do Visual C++, junto com o código de contribuíram com base no recurso atribuído a programação em Visual C++, parâmetros de modelo e assim por diante. A CodeFunction2 objeto pode incluir todos os seus parâmetros, parâmetros de contribuíram com base no recurso atribuído de programação e assim por diante.

O Children pode retornar a propriedade Nothing ou null dependendo do objeto e o idioma. Não há nenhuma exigência para oferecer suporte a esse Visual Studio.

Exemplos

O exemplo a seguir cria um novo namespace e um atributo na classe atual e lista algumas das propriedades do atributo.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.