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


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: