Propriedade CodeClass2.Children

Artigo
05/17/2015

Obtém uma coleção de objetos contidos nessa classe 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 with get

function get Children () : CodeElements

Valor de propriedade

Tipo: CodeElements
Uma coleção de CodeElements .

Comentários

Se a classe de código não tiver nenhum filho, então Nothing ou nulluma referência nula (Nothing no Visual Basic) são retornados.

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

Para iterar pelos membros de um namespace ou de um tipo (classe, struct, a interface, e assim por diante), você deverá ver a interface (QI) ou converter CodeElement a CodeNamespace e usar a propriedade de Members .

Children retorna a coleção de todos os objetos relacionados de CodeElement que podem ser referenciados pela classe de código. Por exemplo, isso pode incluir os elementos de código de metadados para a classe e talvez os declspecs do Visual C++, junto com o código contribuído baseado em recursos atribuído de programação no Visual C++, parâmetros do modelo, e assim por diante.

A propriedade de Children pode retornar Nothing dependendo do objeto e o idioma. Não há nenhum requisito oferecer suporte a isso no Visual Studio.

Dica

Os valores de código de modelagem elementos como classes, estruturas, funções, atributos, representantes, e assim por diante podem ser não determinísticas depois de fazer determinados tipos as edições do, o que significa que seus valores não podem ser confiáveis em para permanecer sempre os mesmos.Para obter mais informações, veja que os valores do elemento do modelo de código da seção podem ser alteradas em Descobrindo código usando o modelo de código (Visual Basic).

Exemplos

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

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ável.