This documentation is archived and is not being maintained.

HtmlElement.AppendChild Method

Adds an element to another element's subtree.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public HtmlElement AppendChild(
	HtmlElement newElement
)

Parameters

newElement
Type: System.Windows.Forms.HtmlElement

The HtmlElement to append to this location in the tree.

Return Value

Type: System.Windows.Forms.HtmlElement
The element after it has been added to the tree.

The HTML Document Object Model (DOM) enables you to alter the run-time contents of an HTML file in a number of ways. Use AppendChild to add new elements to an existing document, or to move an element on the page.

If an element has already been parented, appending an element to another element will automatically remove that element from its previous parent.

Any additions made to a document at run-time using AppendChild will not be persisted when you call the ShowSaveAsDialog method on the WebBrowser control.

The following code example creates a new hyperlink using the CreateElement method and adds it to end of a page using AppendChild on the BODY element. The example requires that your application contains a WebBrowser control named WebBrowser1.

		private void AddUrlToTooltip(string url)
		{
			if (webBrowser1.Document != null)
			{
				HtmlElement elem = webBrowser1.Document.CreateElement("A");
				elem.SetAttribute("HREF", url);
				elem.InnerText = "Visit our Web site for more details.";

				webBrowser1.Document.Body.AppendChild(elem);
			}
		}

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: