HtmlElement Класс

Определение

Представляет элемент HTML в пределах веб-страницы.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
Наследование
HtmlElement

Примеры

В следующем примере кода показано, как проверить произвольный HTML-документ и получить строку, описывающую элементы HTML, с использованием отступов и номеров уровней, используемых для указания того, насколько глубоко вложены элементы в документе.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. В этом примере кода требуется, чтобы в приложении WebBrowser размещается элемент управления с именем 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

Комментарии

HtmlElementпредставляет любой возможный тип элемента в HTML-документе, например BODY, TABLE, и FORM, среди прочих.HtmlElement represents any possible type of element in an HTML document, such as BODY, TABLE, and FORM, among others. Класс предоставляет наиболее распространенные свойства, которые можно найти на всех элементах.The class exposes the most common properties you can expect to find on all elements.

Большинство элементов могут иметь дочерние элементы: другие элементы HTML, размещенные под ними.Most elements can have child elements: other HTML elements that are placed underneath them. Используйте свойство, чтобы проверить, имеет ли данный элемент дочерние элементы Children , и коллекцию для итерации по ним. CanHaveChildrenUse the CanHaveChildren property to test whether a given element has children, and the Children collection to iterate through them. Свойство возвращает объект, HtmlElement в котором вложен текущий элемент. ParentThe Parent property returns the HtmlElement in which the current element is nested.

Часто требуется доступ HtmlElementк атрибутам, свойствам и методам базового элемента, которые не предоставляются напрямую, например SRC атрибут IMG элемента или Submit метода в 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. Методы GetAttribute InvokeMember и SetAttribute позволяют извлекать и изменять любые атрибуты или свойства определенного элемента, а также предоставляют доступ к любым методам, не предоставляемым в управляемом модель DOM (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). Если приложение имеет разрешение на неуправляемый код, можно также получить доступ к непредоставляемым свойствам и DomElement методам с атрибутом.If your application has unmanaged code permission, you can also access unexposed properties and methods with the DomElement attribute.

TagName Используйте свойство, чтобы проверить, относится ли элемент к конкретному типу.Use the TagName property to test whether an element is of a specific type.

Любой HTML-документ можно изменить во время выполнения.Any HTML document can be modified at run time. Вы можете создать новые HtmlElement объекты CreateElement с помощью метода HtmlDocument AppendChild и добавить их в другой элемент, используя методы или 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. Можно также создать элементы в виде HTML-тегов и назначить их InnerHtml свойству существующего элемента.You can also create the elements as HTML tags and assign them to an existing element's InnerHtml property.

Свойства

All

Получает коллекцию HtmlElementCollection всех элементов, расположенных под текущим элементом.Gets an HtmlElementCollection of all elements underneath the current element.

CanHaveChildren

Возвращает значение, указывающее, может ли текущий элемент иметь дочерние элементы.Gets a value indicating whether this element can have child elements.

Children

Получает коллекцию HtmlElementCollection всех дочерних элементов для текущего элемента.Gets an HtmlElementCollection of all children of the current element.

ClientRectangle

Получает границы клиентской области элемента в HTML-документе.Gets the bounds of the client area of the element in the HTML document.

Document

Получает объект HtmlDocument, к которому принадлежит данный элемент.Gets the HtmlDocument to which this element belongs.

DomElement

Получает указатель на неуправляемый интерфейс для этого элемента.Gets an unmanaged interface pointer for this element.

Enabled

Получает или устанавливает возможность ввода пользователем данных в этот элемент.Gets or sets whether the user can input data into this element.

FirstChild

Получает следующий элемент, расположенный под этим элементом в дереве документа.Gets the next element below this element in the document tree.

Id

Возвращает или задает метку, по которой определяется элемент.Gets or sets a label by which to identify the element.

InnerHtml

Возвращает или задает разметку HTML, расположенную под этим элементом.Gets or sets the HTML markup underneath this element.

InnerText

Получает или устанавливает текст, присваиваемый элементу.Gets or sets the text assigned to the element.

Name

Получает или задает имя элемента.Gets or sets the name of the element.

NextSibling

Получает следующий элемент, расположенный в дереве документа на одном уровне с данным элементом.Gets the next element at the same level as this element in the document tree.

OffsetParent

Получает элемент, из которого вычисляется OffsetRectangle.Gets the element from which OffsetRectangle is calculated.

OffsetRectangle

Получает расположение элемента относительно его родительского элемента.Gets the location of an element relative to its parent.

OuterHtml

Возвращает или задает HTML-код текущего элемента.Gets or sets the current element's HTML code.

OuterText

Возвращает или задает текст текущего элемента.Gets or sets the current element's text.

Parent

Получает родительский элемент текущего элемента.Gets the current element's parent element.

ScrollLeft

Возвращает или задает расстояние между краем элемента и левым краем его содержимого.Gets or sets the distance between the edge of the element and the left edge of its content.

ScrollRectangle

Получает размеры области прокрутки элемента.Gets the dimensions of an element's scrollable region.

ScrollTop

Возвращает или задает расстояние между краем элемента и верхним краем его содержимого.Gets or sets the distance between the edge of the element and the top edge of its content.

Style

Получает или задает список стилей текущего элемента, разделенных точкой с запятой.Gets or sets a semicolon-delimited list of styles for the current element.

TabIndex

Возвращает или задает расположение этого элемента в последовательности перехода.Gets or sets the location of this element in the tab order.

TagName

Получает имя HTML-тега.Gets the name of the HTML tag.

Методы

AppendChild(HtmlElement)

Добавляет элемент в поддерево другого элемента.Adds an element to another element's subtree.

AttachEventHandler(String, EventHandler)

Добавляет обработчик событий для события с заданным именем в модели HTML DOM.Adds an event handler for a named event on the HTML Document Object Model (DOM).

DetachEventHandler(String, EventHandler)

Удаляет обработчик событий из события с заданным именем в модели HTML DOM.Removes an event handler from a named event on the HTML Document Object Model (DOM).

Equals(Object)

Проверяет, равен ли переданный объект текущему элементу.Tests if the supplied object is equal to the current element.

Focus()

Помещает фокус ввода пользователя в текущий элемент.Puts user input focus on the current element.

GetAttribute(String)

Возвращает значение атрибута с заданным именем в элементе.Retrieves the value of the named attribute on the element.

GetElementsByTagName(String)

Возвращает коллекцию элементов, представленных в HTML-коде, по заданному тегу HTML.Retrieves a collection of elements represented in HTML by the specified HTML tag.

GetHashCode()

Служит хэш-функцией для определенного типа.Serves as a hash function for a particular type.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement)

Вставляет новый элемент в модель DOM.Insert a new element into the Document Object Model (DOM).

InvokeMember(String)

Выполняет невыявленный метод в базовом элементе DOM данного элемента.Executes an unexposed method on the underlying DOM element of this element.

InvokeMember(String, Object[])

Выполняет функцию, определенную в текущей HTML-странице с помощью языка скриптов.Executes a function defined in the current HTML page by a scripting language.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
RaiseEvent(String)

Вызывает для события с указанным именем все зарегистрированные обработчики событий.Causes the named event to call all registered event handlers.

RemoveFocus()

Удаляет фокус из текущего элемента, если этот элемент имеет фокус.Removes focus from the current element, if that element has focus.

ScrollIntoView(Boolean)

Выполняет прокрутку документа, содержащего этот элемент, пока верхний или нижний край элемента не окажется выровненным с окном документа.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)

Задает значение атрибута с заданным именем в элементе.Sets the value of the named attribute on the element.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Операторы

Equality(HtmlElement, HtmlElement)

Проверяет равенство двух элементов.Compares two elements for equality.

Inequality(HtmlElement, HtmlElement)

Проверяет неравенство двух объектов HtmlElement.Compares two HtmlElement objects for inequality.

События

Click

Происходит, когда пользователь щелкает элемент левой кнопкой мыши.Occurs when the user clicks on the element with the left mouse button.

DoubleClick

Происходит, когда пользователь дважды в течение краткого промежутка времени щелкает элемент левой кнопкой мыши.Occurs when the user clicks the left mouse button over an element twice, in rapid succession.

Drag

Происходит, когда пользователь перетаскивает текст в различные места.Occurs when the user drags text to various locations.

DragEnd

Происходит, когда пользователь завершает операцию перетаскивания.Occurs when a user finishes a drag operation.

DragLeave

Происходит, когда пользователь прекращает перетаскивание объекта через этот элемент.Occurs when the user is no longer dragging an item over this element.

DragOver

Происходит, когда пользователь перетаскивает текст над элементом.Occurs when the user drags text over the element.

Focusing

Происходит, когда элемент впервые получает фокус ввода пользователя.Occurs when the element first receives user input focus.

GotFocus

Происходит, когда элемент получил фокус ввода пользователя.Occurs when the element has received user input focus.

KeyDown

Происходит, когда пользователь нажимает клавишу на клавиатуре.Occurs when the user presses a key on the keyboard.

KeyPress

Происходит, когда пользователь нажимает и отпускает клавишу на клавиатуре.Occurs when the user presses and releases a key on the keyboard.

KeyUp

Происходит, когда пользователь отпускает клавишу на клавиатуре.Occurs when the user releases a key on the keyboard.

LosingFocus

Происходит, когда элемент теряет фокус ввода пользователя.Occurs when the element is losing user input focus.

LostFocus

Происходит, когда элемент потерял фокус ввода пользователя.Occurs when the element has lost user input focus.

MouseDown

Происходит, когда пользователь нажимает кнопку мыши.Occurs when the user presses a mouse button.

MouseEnter

Происходит, когда пользователь впервые наводит указатель мыши на текущий элемент.Occurs when the user first moves the mouse cursor over the current element.

MouseLeave

Происходит, когда пользователь выводит указатель мыши из текущего элемента.Occurs when the user moves the mouse cursor off of the current element.

MouseMove

Происходит, когда пользователь перемещает указатель мыши по элементу.Occurs when the user moves the mouse cursor across the element.

MouseOver

Происходит, когда указатель мыши входит в пределы элемента.Occurs when the mouse cursor enters the bounds of the element.

MouseUp

Происходит, когда пользователь отпускает кнопку мыши.Occurs when the user releases a mouse button.

Применяется к

Дополнительно