CodeClass2.Children プロパティ

[アーティクル]
08/09/2011

このコードクラスに含まれているオブジェクトのコレクションを取得します。

名前空間: EnvDTE80
アセンブリ: EnvDTE80 (EnvDTE80.dll 内)

構文

'宣言
ReadOnly Property Children As CodeElements
    Get

CodeElements Children { get; }

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

abstract Children : CodeElements

function get Children () : CodeElements

プロパティ値

型: EnvDTE.CodeElements
CodeElements コレクション。

実装

CodeClass.Children

解説

コードクラスに子がない場合は、Nothing または nullnull 参照 (Visual Basic では Nothing) が返されます。

このプロパティは、主に Visual C++ で使用されます。 Children は、コード要素から返すことができるすべてのオブジェクトを返します。たとえば、クラスの場合は、メンバー、ベース、実装されたインターフェイス、属性、コメントなどを返します。

特定の名前空間またはタイプ (クラス、構造体、インターフェイスなど) のメンバーを反復処理するには、インターフェイスのサポートの有無を確認するか CodeElement を CodeNamespace にキャストしてから、Members プロパティを使用する必要があります。

Children は、コードクラスを通じて参照できる、関連付けられたすべての CodeElement オブジェクトのコレクションを返します。たとえば、Visual C++ の属性付きプログラミング機能に基づいて提供されたコードやテンプレートパラメーターなどに加えて、クラスのメタデータコード要素や、Visual C++ の declspec などが含まれます。

オブジェクトや言語によっては、Children プロパティが Nothing を返す場合もあります。 Visual Studio でこれをサポートするための要件は特にありません。

注意

特定の種類の編集を行うと、クラス、構造体、関数、属性、デリゲートなどのコードモデル要素が非確定的な値になる場合があります。つまり、これらの要素の値は、常に同じ値になるとは限りません。詳細については、「コードモデルを使用したコードの調査 (Visual Basic)」で、コードモデル要素値を変更する方法についての説明を参照してください。

例

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