HtmlElement HtmlElement HtmlElement HtmlElement Class

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
HtmlElementHtmlElementHtmlElementHtmlElement

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 sangría y números de nivel para indicar cómo profundamente anidados de los elementos están 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 los hosts de aplicación una WebBrowser control denominado WebBrowser1.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

HtmlElement representa cualquier tipo posibles de elemento en un documento HTML, como BODY, TABLE, y 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 encontrar 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 puede tener elementos secundarios: otros elementos HTML situados por debajo de ellos.Most elements can have child elements: other HTML elements that are placed underneath them. Use la CanHaveChildren propiedad para comprobar si un elemento determinado tiene elementos secundarios y el Children colección para recorrer en iteración a través de ellos.Use the CanHaveChildren property to test whether a given element has children, and the Children collection to iterate through them. El Parent propiedad devuelve el HtmlElement en que se anide el elemento actual.The Parent property returns the HtmlElement in which the current element is nested.

A menudo necesitará acceso a atributos, propiedades y métodos en el elemento subyacente que no están directamente expuestos por HtmlElement, como el SRC atributo una IMG elemento o el Submit método en un 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. El GetAttribute y SetAttribute métodos permiten recuperar y modificar cualquier atributo o propiedad en un elemento específico, mientras que InvokeMember proporciona acceso a los métodos no expuestos en administrado Document Object Model (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 no administrada permiso de código, también puede tener acceso no expuestas propiedades y métodos con el DomElement atributo.If your application has unmanaged code permission, you can also access unexposed properties and methods with the DomElement attribute.

Use el 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 puede modificarse en tiempo de ejecución.Any HTML document can be modified at run time. Puede crear nuevos HtmlElement los objetos que tienen el CreateElement método de HtmlDocumenty agregarlos a otro elemento utilizando el AppendChild o InsertAdjacentElement métodos.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 un elemento existente InnerHtml propiedad.You can also create the elements as HTML tags and assign them to an existing element's InnerHtml property.

Propiedades

All All All 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 CanHaveChildren CanHaveChildren 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 Children Children 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 ClientRectangle ClientRectangle 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 Document Document Document

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

DomElement DomElement DomElement DomElement

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

Enabled Enabled Enabled 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 FirstChild FirstChild 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 Id Id Id

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

InnerHtml InnerHtml InnerHtml InnerHtml

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

InnerText InnerText InnerText InnerText

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

Name Name Name Name

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

NextSibling NextSibling NextSibling 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 OffsetParent OffsetParent 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 OffsetRectangle OffsetRectangle 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 OuterHtml OuterHtml OuterHtml

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

OuterText OuterText OuterText OuterText

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

Parent Parent Parent Parent

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

ScrollLeft ScrollLeft ScrollLeft 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 ScrollRectangle ScrollRectangle ScrollRectangle

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

ScrollTop ScrollTop ScrollTop 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 Style Style 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 TabIndex TabIndex 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 TagName TagName TagName

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

Métodos

AppendChild(HtmlElement) AppendChild(HtmlElement) AppendChild(HtmlElement) AppendChild(HtmlElement)

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

AttachEventHandler(String, EventHandler) AttachEventHandler(String, EventHandler) AttachEventHandler(String, EventHandler) 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) DetachEventHandler(String, EventHandler) DetachEventHandler(String, EventHandler) 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) Equals(Object) Equals(Object) Equals(Object)

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

Focus() Focus() Focus() Focus()

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

GetAttribute(String) GetAttribute(String) GetAttribute(String) GetAttribute(String)

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

GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String) 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() GetHashCode() GetHashCode() GetHashCode()

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

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement) InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement) InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement) 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) InvokeMember(String) InvokeMember(String) 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[]) InvokeMember(String, Object[]) InvokeMember(String, Object[]) 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() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
RaiseEvent(String) RaiseEvent(String) RaiseEvent(String) 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() RemoveFocus() RemoveFocus() 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) ScrollIntoView(Boolean) ScrollIntoView(Boolean) 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) SetAttribute(String, String) SetAttribute(String, String) SetAttribute(String, String)

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

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Eventos

Click Click Click 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 DoubleClick DoubleClick 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 Drag Drag Drag

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

DragEnd DragEnd DragEnd DragEnd

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

DragLeave DragLeave DragLeave 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 DragOver DragOver DragOver

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

Focusing Focusing Focusing 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 GotFocus GotFocus GotFocus

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

KeyDown KeyDown KeyDown KeyDown

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

KeyPress KeyPress KeyPress 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 KeyUp KeyUp KeyUp

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

LosingFocus LosingFocus LosingFocus LosingFocus

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

LostFocus LostFocus LostFocus LostFocus

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

MouseDown MouseDown MouseDown MouseDown

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

MouseEnter MouseEnter MouseEnter 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 MouseLeave MouseLeave 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 MouseMove MouseMove 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 MouseOver MouseOver 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 MouseUp MouseUp MouseUp

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

Operadores

Equality(HtmlElement, HtmlElement) Equality(HtmlElement, HtmlElement) Equality(HtmlElement, HtmlElement) Equality(HtmlElement, HtmlElement)

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

Inequality(HtmlElement, HtmlElement) Inequality(HtmlElement, HtmlElement) Inequality(HtmlElement, HtmlElement) Inequality(HtmlElement, HtmlElement)

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

Se aplica a

Consulte también: