HtmlElement Clase

Definición

Representa un elemento HTML dentro de una página web.Represents an HTML element inside of a Web page.

public ref class HtmlElement sealed
public sealed class HtmlElement
type HtmlElement = class
Public NotInheritable Class HtmlElement
Herencia
HtmlElement

Ejemplos

En el ejemplo de código siguiente se muestra cómo examinar un documento HTML arbitrario y derivar una cadena que describe los elementos HTML, con valores de sangría y de nivel que se usan para indicar la profundidad de anidación de los elementos en el documento.The following code example shows how to examine an arbitrary HTML document and derive a string describing the HTML elements, with indentation and level numbers used to indicate how deeply nested the elements are in the document. Este ejemplo de código requiere que la aplicación hospede WebBrowser un control WebBrowser1denominado.This code example requires that your application hosts a WebBrowser control named 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

Comentarios

HtmlElementrepresenta cualquier tipo de elemento posible de un documento HTML, BODYcomo, TABLEy FORM, entre otros.HtmlElement represents any possible type of element in an HTML document, such as BODY, TABLE, and FORM, among others. La clase expone las propiedades más comunes que puede esperar buscar en todos los elementos.The class exposes the most common properties you can expect to find on all elements.

La mayoría de los elementos pueden tener elementos secundarios: otros elementos HTML que se colocan debajo de ellos.Most elements can have child elements: other HTML elements that are placed underneath them. Utilice la CanHaveChildren propiedad para comprobar si un elemento determinado tiene elementos secundarios y la Children colección para recorrer en iteración.Use the CanHaveChildren property to test whether a given element has children, and the Children collection to iterate through them. La Parent propiedad devuelve el HtmlElement en el que está anidado el elemento actual.The Parent property returns the HtmlElement in which the current element is nested.

A menudo es necesario tener acceso a los atributos, propiedades y métodos del elemento subyacente que no están expuestos directamente HtmlElementpor, como el SRC atributo en un IMG elemento o el Submit método en FORM.You often need access to attributes, properties, and methods on the underlying element that are not directly exposed by HtmlElement, such as the SRC attribute on an IMG element or the Submit method on a FORM. Los GetAttribute métodos SetAttribute y permiten recuperar y modificar cualquier atributo o propiedad de un elemento específico, mientras InvokeMember que proporciona acceso a cualquier método no expuesto en el Document Object Model administrado (dom).The GetAttribute and SetAttribute methods enable you to retrieve and alter any attribute or property on a specific element, while InvokeMember provides access to any methods not exposed in the managed Document Object Model (DOM). Si la aplicación tiene permiso de código no administrado, también puede tener acceso a propiedades y métodos no expuestos con DomElement el atributo.If your application has unmanaged code permission, you can also access unexposed properties and methods with the DomElement attribute.

Utilice la TagName propiedad para comprobar si un elemento es de un tipo específico.Use the TagName property to test whether an element is of a specific type.

Cualquier documento HTML se puede modificar en tiempo de ejecución.Any HTML document can be modified at run time. HtmlElement Puede crear nuevos objetos con el HtmlDocument CreateElement método de y agregarlos a otro elemento mediante los AppendChild métodos o InsertAdjacentElement .You can create new HtmlElement objects with the CreateElement method of HtmlDocument, and add them to another element using the AppendChild or InsertAdjacentElement methods. También puede crear los elementos como etiquetas HTML y asignarlos a la propiedad de InnerHtml un elemento existente.You can also create the elements as HTML tags and assign them to an existing element's InnerHtml property.

Propiedades

All

Obtiene una colección HtmlElementCollection de todos los elementos que se encuentran por debajo del elemento actual.Gets an HtmlElementCollection of all elements underneath the current element.

CanHaveChildren

Obtiene un valor que indica si este elemento puede tener elementos secundarios.Gets a value indicating whether this element can have child elements.

Children

Obtiene una colección HtmlElementCollection de todos los elementos secundarios del elemento actual.Gets an HtmlElementCollection of all children of the current element.

ClientRectangle

Obtiene los límites del área de cliente del elemento en el documento HTML.Gets the bounds of the client area of the element in the HTML document.

Document

Obtiene el HtmlDocument al que pertenece este elemento.Gets the HtmlDocument to which this element belongs.

DomElement

Obtiene un puntero de interfaz no administrada para este elemento.Gets an unmanaged interface pointer for this element.

Enabled

Obtiene o establece si el usuario puede escribir datos en este elemento.Gets or sets whether the user can input data into this element.

FirstChild

Obtiene el siguiente elemento situado debajo de este elemento en el árbol del documento.Gets the next element below this element in the document tree.

Id

Obtiene o establece una etiqueta mediante la que identificar el elemento.Gets or sets a label by which to identify the element.

InnerHtml

Obtiene o establece el código HTML situado por debajo de este elemento.Gets or sets the HTML markup underneath this element.

InnerText

Obtiene o establece el texto asignado al elemento.Gets or sets the text assigned to the element.

Name

Obtiene o establece el nombre del elemento.Gets or sets the name of the element.

NextSibling

Obtiene el siguiente elemento del mismo nivel que este elemento en el árbol del documento.Gets the next element at the same level as this element in the document tree.

OffsetParent

Obtiene el elemento a partir del cual se calcula el valor de la propiedad OffsetRectangle.Gets the element from which OffsetRectangle is calculated.

OffsetRectangle

Obtiene la ubicación de un elemento con respecto a su elemento primario.Gets the location of an element relative to its parent.

OuterHtml

Obtiene o establece el código HTML del elemento actual.Gets or sets the current element's HTML code.

OuterText

Obtiene o establece el texto del elemento actual.Gets or sets the current element's text.

Parent

Obtiene el elemento primario del elemento actual.Gets the current element's parent element.

ScrollLeft

Obtiene o establece la distancia entre el borde del elemento y el borde izquierdo de su contenido.Gets or sets the distance between the edge of the element and the left edge of its content.

ScrollRectangle

Obtiene las dimensiones de la región desplazable de un elemento.Gets the dimensions of an element's scrollable region.

ScrollTop

Obtiene o establece la distancia entre el borde del elemento y el borde superior de su contenido.Gets or sets the distance between the edge of the element and the top edge of its content.

Style

Obtiene o establece una lista de estilos separados por punto y coma para el elemento actual.Gets or sets a semicolon-delimited list of styles for the current element.

TabIndex

Obtiene o establece la ubicación de este elemento en el orden de tabulación.Gets or sets the location of this element in the tab order.

TagName

Obtiene el nombre de la etiqueta HTML.Gets the name of the HTML tag.

Métodos

AppendChild(HtmlElement)

Agrega un elemento al subárbol de otro elemento.Adds an element to another element's subtree.

AttachEventHandler(String, EventHandler)

Agrega un controlador de eventos para un evento con nombre al Modelo de objetos de documento (DOM) HTML.Adds an event handler for a named event on the HTML Document Object Model (DOM).

DetachEventHandler(String, EventHandler)

Quita un controlador de eventos de un evento con nombre del Modelo de objetos de documento (DOM) HTML.Removes an event handler from a named event on the HTML Document Object Model (DOM).

Equals(Object)

Prueba si el objeto proporcionado es igual al elemento actual.Tests if the supplied object is equal to the current element.

Focus()

Coloca el foco de entrada del usuario en el elemento actual.Puts user input focus on the current element.

GetAttribute(String)

Obtiene el valor del atributo con nombre del elemento.Retrieves the value of the named attribute on the element.

GetElementsByTagName(String)

Recupera una colección de elementos que se representan en HTML mediante la etiqueta HTML especificada.Retrieves a collection of elements represented in HTML by the specified HTML tag.

GetHashCode()

Actúa como función hash para un tipo concreto.Serves as a hash function for a particular type.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement)

Inserta un nuevo elemento en el Modelo de objetos de documento (DOM).Insert a new element into the Document Object Model (DOM).

InvokeMember(String)

Ejecuta un método no expuesto en el elemento DOM subyacente de este elemento.Executes an unexposed method on the underlying DOM element of this element.

InvokeMember(String, Object[])

Ejecuta una función definida en la página HTML actual por un lenguaje de scripting.Executes a function defined in the current HTML page by a scripting language.

MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
RaiseEvent(String)

Hace que el evento con nombre llame a todos los controladores de eventos registrados.Causes the named event to call all registered event handlers.

RemoveFocus()

Quita el foco del elemento actual, en caso de que dicho elemento tenga el foco.Removes focus from the current element, if that element has focus.

ScrollIntoView(Boolean)

Se desplaza por el documento donde está incluido este elemento hasta que el borde superior o inferior del elemento se alinea con la ventana del documento.Scrolls through the document containing this element until the top or bottom edge of this element is aligned with the document's window.

SetAttribute(String, String)

Establece el valor del atributo con nombre del elemento.Sets the value of the named attribute on the element.

ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Operadores

Equality(HtmlElement, HtmlElement)

Compara dos elementos para determinar si son iguales.Compares two elements for equality.

Inequality(HtmlElement, HtmlElement)

Compara dos objetos HtmlElement para determinar si no son iguales.Compares two HtmlElement objects for inequality.

Eventos

Click

Se produce cuando el usuario hace clic en el elemento con el botón primario del mouse.Occurs when the user clicks on the element with the left mouse button.

DoubleClick

Se produce cuando el usuario hace clic dos veces seguidas con el botón primario del mouse en un elemento, en una sucesión rápida.Occurs when the user clicks the left mouse button over an element twice, in rapid succession.

Drag

Se produce cuando el usuario arrastra el texto a varias ubicaciones.Occurs when the user drags text to various locations.

DragEnd

Se produce cuando un usuario finaliza una operación de arrastrar.Occurs when a user finishes a drag operation.

DragLeave

Se produce cuando el usuario deja de arrastrar un elemento sobre este elemento.Occurs when the user is no longer dragging an item over this element.

DragOver

Se produce cuando el usuario arrastra el texto sobre el elemento.Occurs when the user drags text over the element.

Focusing

Se produce cuando el elemento recibe por primera vez el foco de entrada del usuario.Occurs when the element first receives user input focus.

GotFocus

Se produce cuando el elemento ha recibido el foco de entrada del usuario.Occurs when the element has received user input focus.

KeyDown

Se produce cuando el usuario presiona una tecla del teclado.Occurs when the user presses a key on the keyboard.

KeyPress

Se produce cuando el usuario presiona y suelta una tecla del teclado.Occurs when the user presses and releases a key on the keyboard.

KeyUp

Se produce cuando el usuario suelta una tecla del teclado.Occurs when the user releases a key on the keyboard.

LosingFocus

Se produce cuando el elemento está perdiendo el foco de entrada del usuario.Occurs when the element is losing user input focus.

LostFocus

Se produce cuando el elemento ha perdido el foco de entrada del usuario.Occurs when the element has lost user input focus.

MouseDown

Se produce cuando el usuario presiona un botón del mouse.Occurs when the user presses a mouse button.

MouseEnter

Se produce cuando el usuario mueve por primera vez el cursor del mouse sobre el elemento actual.Occurs when the user first moves the mouse cursor over the current element.

MouseLeave

Se produce cuando el usuario mueve el cursor del mouse fuera del elemento actual.Occurs when the user moves the mouse cursor off of the current element.

MouseMove

Se produce cuando el usuario mueve el cursor del mouse sobre el elemento.Occurs when the user moves the mouse cursor across the element.

MouseOver

Se produce cuando el cursor del mouse entra en los límites del elemento.Occurs when the mouse cursor enters the bounds of the element.

MouseUp

Se produce cuando el usuario suelta un botón del mouse.Occurs when the user releases a mouse button.

Se aplica a

Consulte también: