Propriedade CodeAttribute2.Children

Artigo
10/26/2012

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

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.

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 todos os objetos retornável de um elemento de código.Uma classe, por exemplo, retorna os membros, bases, interfaces implementadas, atributos, comentários e assim por diante.

Para iterar pelos membros de um namespace ou tipo (classe, struct, interface e assim por diante), você deve consultar a interface (QI) ou cast a CodeElement o objeto para um CodeNamespace de objeto e, em seguida, use o Members propriedade.

O Children propriedade retorna a coleção de todos os tipo de CodeElement2 objetos que possam ser referenciados através desse elemento de código.Por exemplo, para um CodeClass2 , isso pode incluir elementos de metadados de código para a classe e objeto talvez declspecs os Visual C++, junto com código contribuíram com base na programação atribuído recursos no 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 propriedade pode retornar Nothing ou null dependendo do objeto e o idioma.Não há nenhuma exigência para oferecer suporte a isso em Visual Studio.

Exemplos

O exemplo a seguir cria um novo espaço para nome e o 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.