HtmlElement.Children プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

HtmlElement.Children プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在の要素のすべての子で構成される HtmlElementCollection を取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Children As HtmlElementCollection

Visual Basic (使用法)

Dim instance As HtmlElement
Dim value As HtmlElementCollection

value = instance.Children

public HtmlElementCollection Children { get;
 }

C++

public:
property HtmlElementCollection^ Children {
    HtmlElementCollection^ get ();
}

/** @property */
public HtmlElementCollection get_Children ()

JScript

public function get Children
 () : HtmlElementCollection

プロパティ値
現在の要素を親とするすべての HtmlElement オブジェクトのコレクション。

解説

HTML ファイルに含まれる多くの要素は、その下位に他の HTML 要素を持つことができます。Children コレクションは、ドキュメントのツリー構造を調べるための単純な機構を実現します。

Children は、現在の要素を直接的な親とする要素のみ公開します。TABLE 要素を表す HtmlElement の場合、Children は、その TABLE 内にあるすべての TR (行) 要素を返します。TR 要素に含まれる TD (セル) 要素を取得するには、各 TR 要素の Children コレクションを使用するか、HtmlElement の All コレクションを使用します。

このコレクションに含まれる要素は、格納されている順序で返されるとは限りません。

CanHaveChildren が false の場合、Children は常に空です。

使用例

次のコード例では、任意の HTML ドキュメントを調べて、その要素がドキュメント内で入れ子になっている深さを示すインデント数とレベル数を記載した、要素について説明する文字列を取得します。この操作は、ドキュメントの最上位にある HTML 要素を開始点として、すべての要素の Children コレクションを再帰的に検索することによって行われます。このコード例では、アプリケーションに WebBrowser1 という名前の WebBrowser コントロールが存在する必要があります。

private void PrintDomBegin()
{
    if (webBrowser1.Document != null)
    {
        HtmlElementCollection elemColl = null;
        HtmlDocument doc = webBrowser1.Document;
        if (doc != null)
        {
            elemColl = doc.GetElementsByTagName("HTML");
            String str = PrintDom(elemColl, new System.Text.StringBuilder(),
 0);
            webBrowser1.DocumentText = str;
        }
    }
}

private string PrintDom(HtmlElementCollection
 elemColl, System.Text.StringBuilder returnStr, Int32 depth)
{
    System.Text.StringBuilder str = new System.Text.StringBuilder();

    foreach (HtmlElement elem in elemColl)
    {
        string elemName;

        elemName = elem.GetAttribute("ID");
        if (elemName == null || elemName.Length
 == 0)
        {
            elemName = elem.GetAttribute("name");
            if (elemName == null || elemName.Length
 == 0)
            {
                elemName = "<no name>";
            }
        }

        str.Append(' ', depth * 4);
        str.Append(elemName + ": " + elem.TagName + "(Level "
 + depth + ")");
        returnStr.AppendLine(str.ToString());

        if (elem.CanHaveChildren)
        {
            PrintDom(elem.Children, returnStr, depth + 1);
        }

        str.Remove(0, str.Length);
    }

    return(returnStr.ToString());
}