HtmlElement.Children Propriedade

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

public System.Windows.Forms.HtmlElementCollection Children { get; }

member this.Children : System.Windows.Forms.HtmlElementCollection

Public ReadOnly Property Children As HtmlElementCollection

Valor de Propriedade

Uma coleção de todos os HtmlElement objetos que têm o elemento corrente como pai.

Exemplos

O exemplo de código seguinte examina um documento HTML arbitrário e deriva uma cadeia que descreve os elementos, com números de indentação e nível usados para indicar quão profundamente os elementos estão aninhados no documento. Faz isto pesquisando recursivamente a Children coleção de todos os elementos, começando pelo elemento HTML no topo do documento. Este exemplo de código exige que a sua aplicação tenha um WebBrowser controlo chamado WebBrowser1.

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

Private Sub PrintDomBegin()
    If (WebBrowser1.Document IsNot Nothing) Then
        Dim ElemColl As HtmlElementCollection

        Dim Doc As HtmlDocument = WebBrowser1.Document
        If (Not (Doc Is Nothing)) Then
            ElemColl = Doc.GetElementsByTagName("HTML")
            Dim Str As String = PrintDom(ElemColl, New System.Text.StringBuilder(), 0)

            WebBrowser1.DocumentText = Str
        End If
    End If
End Sub

Private Function PrintDom(ByVal ElemColl As HtmlElementCollection, ByRef ReturnStr As System.Text.StringBuilder, ByVal Depth As Integer) As String
    Dim Str As New System.Text.StringBuilder()

    For Each Elem As HtmlElement In ElemColl
        Dim ElemName As String

        ElemName = Elem.GetAttribute("ID")
        If (ElemName Is Nothing Or ElemName.Length = 0) Then
            ElemName = Elem.GetAttribute("name")
            If (ElemName Is Nothing Or ElemName.Length = 0) Then
                ElemName = "<no name>"
            End If
        End If

        Str.Append(CChar(" "), Depth * 4)
        Str.Append(ElemName & ": " & Elem.TagName & "(Level " & Depth & ")")
        ReturnStr.AppendLine(Str.ToString())

        If (Elem.CanHaveChildren) Then
            PrintDom(Elem.Children, ReturnStr, Depth + 1)
        End If

        Str.Remove(0, Str.Length)
    Next

    PrintDom = ReturnStr.ToString()
End Function

Observações

Muitos dos elementos dentro de um ficheiro HTML podem ter outros elementos HTML por baixo. A Children coleção fornece um mecanismo simples para explorar a estrutura em árvore de um documento.

Children expõe apenas elementos cujo pai direto é o elemento atual. Se tiver um para um HtmlElement elemento, TABLE irá dar-lhe todos os Children elementos (linha) dentro do TR.TABLE Para recuperar os TD elementos (célula) contidos dentro dos TR elementos, terá de usar ou a Children coleção em cada elemento individual TR , ou usar a All coleção em HtmlElement.

Os elementos desta coleção não têm garantia de estar na ordem de origem.

Se CanHaveChildren for false, Children estará sempre vazio.

Ver também

• All