NET Framework 類庫 HtmlElement 類

 

命名空間：  System.Windows.Forms
程式集：  System.Windows.Forms（在 System.Windows.Forms.dll 中）

HtmlElement 表示一個 HTML 文檔中可能存在的任何類型的元素，如：BODY、TABLE 和 FORM 等。此類公開可以在所有元素中找到的最常用屬性。

大多數元素可以擁有“子項目”：即放置在其下的其他 HTML 元素。使用 CanHaveChildren 屬性測試給定元素是否有子級，並使用 Children 集合逐一查看這些子級。Parent 屬性返回在其中嵌套當前元素的 HtmlElement。

經常需要訪問基礎元素上未由 HtmlElement 直接公開的屬性 (Attribute)、屬性 (Property) 和方法，如 IMG 元素上的 SRC 屬性 (Attribute) 或 FORM 上的 Submit 方法。GetAttribute 和 SetAttribute 方法使您可以檢索和更改某個特定元素中的任何屬性 (Attribute) 或 (Property)，而 InvokeMember 提供對未在託管文件物件模型 (DOM) 中公開的任何方法的訪問。如果應用程式擁有Unmanaged 程式碼許可權，則還可以使用 DomElement 屬性 (Attribute) 訪問未公開的屬性 (Property) 及方法。

使用 TagName 屬性 (Property) 測試元素是否屬於某種特定類型。

任何 HTML 文檔均可在運行時修改。您可以使用 HtmlDocument 的 CreateElement 方法建立新的 HtmlElement 對象，並使用 AppendChild 方法或 InsertAdjacentElement 方法將這些新對象添加到其他元素中。還可以建立 HTML 標籤形式的元素，並將它們分配給現有元素的 InnerHtml 屬性。

 

下面的程式碼範例示範如何檢查一個任意 HTML 文檔並派生一個描述 HTML 元素的字串，該字串帶有縮排及縮排等級編號，用於指示這些元素在此文檔中的嵌套深度。此程式碼範例要求應用程式承載一個名為 WebBrowser1 的 WebBrowser 控制項。

 

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

表示網頁內的一個 HTML 元素。