HtmlElement Classe

Definição

public ref class HtmlElement sealed

public sealed class HtmlElement

type HtmlElement = class

Public NotInheritable Class HtmlElement

Herança

Object

HtmlElement

Exemplos

O exemplo de código seguinte mostra como examinar um documento HTML arbitrário e derivar uma cadeia que descreva os elementos HTML, com números de indentação e nível usados para indicar quão profundamente os elementos estão aninhados no documento. Este exemplo de código exige que a sua aplicação aloje 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

HtmlElement representa qualquer tipo possível de elemento num documento HTML, como BODY, TABLE, e FORM, entre outros. A classe expõe as propriedades mais comuns que pode esperar encontrar em todos os elementos.

A maioria dos elementos pode ter elementos filhos: outros elementos HTML que são colocados por baixo deles. Use a CanHaveChildren propriedade para testar se um dado elemento tem filhos, e a Children coleção para iterar através deles. A Parent propriedade devolve o HtmlElement em que o elemento atual está aninhado.

Muitas vezes é necessário aceder a atributos, propriedades e métodos no elemento subjacente que não são diretamente expostos por HtmlElement, como o SRC atributo num IMG elemento ou o Submit método num FORM. Os GetAttribute métodos and SetAttribute permitem-lhe recuperar e alterar qualquer atributo ou propriedade num elemento específico, ao mesmo tempo InvokeMember que dão acesso a quaisquer métodos não expostos no Modelo de Objetos de Documento (DOM) gerido. Se a sua aplicação tiver permissão de código não gerido, também pode aceder a propriedades e métodos não expostos com o DomElement atributo.

Use a TagName propriedade para testar se um elemento é de um tipo específico.

Qualquer documento HTML pode ser modificado em tempo de execução. Pode criar novos HtmlElement objetos com o CreateElement método de HtmlDocument, e adicioná-los a outro elemento usando os AppendChild métodos ou InsertAdjacentElement . Também podes criar os elementos como etiquetas HTML e atribuí-los à propriedade de InnerHtml um elemento existente.

Ver também

• IHTMLElement Interface
• IHTMLElement2 Interface
• IHTMLElement3 Interface
• IHTMLElement4 Interface