Export (0) Print
Expand All

HtmlElement.InnerHtml Property

Gets or sets the HTML markup underneath this element.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public string InnerHtml { get; set; }
/** @property */
public String get_InnerHtml ()

/** @property */
public void set_InnerHtml (String value)

public function get InnerHtml () : String

public function set InnerHtml (value : String)

Not applicable.

Property Value

The HTML markup that defines the child elements of the current element.

Exception typeCondition

NotSupportedException

Creating child elements on this element is not allowed.

There are several ways to add new elements to an existing HTML page, such as the AppendChild and InsertAdjacentElement methods. Using InnerHtml is often the fastest way to add new content when you have to set many attributes or styles on your new elements.

InnerHtml differs from OuterHtml in that InnerHtml will not include the HTML that represents the object you are calling. See OuterHtml for more information about the difference between these two properties.

Setting InnerHtml destroys any children previously appended to the element. If you retrieve an element from the DOM and then assign new HTML to its parents' InnerHtml property, your reference to that element will be useless, and its behavior when it calls its properties and methods is undefined.

For some elements, setting InnerHtml is not a valid operation. Some HTML tags have no closing tag, such as the IMG tag, and therefore cannot contain nested elements. Some tags, such as the SCRIPT tag, can only contain text content; setting InnerHtml will result in an error. For both types of tags, the CanHaveChildren property will return false. However, you also cannot set InnerHtml on TABLE and TR elements, as assigning malformed HTML to these elements could corrupt the rendering of the document. Use AppendChild or the insertRow and insertCell methods on the unmanaged IHTMLTable interface to add rows and cells to a TABLE.

If you need only to assign text to an element and not HTML markup, use the InnerText property instead.

Assigning a value to InnerHtml will destroy any text values previously assigned using InnerText.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show:
© 2015 Microsoft