Freigeben über


HtmlElement.InnerHtml Eigenschaft

Definition

Ruft das HTML-Markup unter diesem Element ab oder legt es fest.

public:
 property System::String ^ InnerHtml { System::String ^ get(); void set(System::String ^ value); };
public string InnerHtml { get; set; }
member this.InnerHtml : string with get, set
Public Property InnerHtml As String

Eigenschaftswert

Das HTML-Markup, das die untergeordneten Elemente des aktuellen Elements definiert.

Ausnahmen

Das Erstellen untergeordneter Elemente für dieses Element ist nicht zulässig.

Hinweise

Es gibt verschiedene Möglichkeiten, einer vorhandenen HTML-Seite neue Elemente hinzuzufügen, z. B. die AppendChild methoden.InsertAdjacentElement Die Verwendung InnerHtml ist häufig die schnellste Möglichkeit, neue Inhalte hinzuzufügen, wenn Sie viele Attribute oder Formatvorlagen für Ihre neuen Elemente festlegen müssen.

InnerHtml unterscheidet sich davon OuterHtml , dass InnerHtml der HTML-Code nicht enthalten wird, der das objekt darstellt, das Sie aufrufen. Weitere Informationen zu dem Unterschied zwischen diesen beiden Eigenschaften finden Sie unter.See OuterHtml for more information about the difference between these two properties.

Durch festlegen InnerHtml werden alle untergeordneten Elemente zerstört, die zuvor an das Element angefügt wurden. Wenn Sie ein Element aus dem DOM abrufen und der übergeordneten InnerHtml Eigenschaft dann neuen HTML-Code zuweisen, ist ihr Verweis auf dieses Element nutzlos, und das Verhalten, wenn es seine Eigenschaften und Methoden aufruft, ist nicht definiert.

Bei einigen Elementen ist die Einstellung InnerHtml kein gültiger Vorgang. Einige HTML-Tags weisen kein schließende Tag auf, z. B. das IMG Tag, und daher können keine geschachtelten Elemente enthalten. Einige Tags, z. B. das SCRIPT Tag, können nur Textinhalte enthalten. Die Einstellung InnerHtml führt zu einem Fehler. Für beide Arten von Tags gibt die CanHaveChildren Eigenschaft zurück false. Sie können jedoch auch keine Elemente TABLETR festlegenInnerHtml, da das Zuweisen falsch formatierter HTML-Code zu diesen Elementen das Rendern des Dokuments beeinträchtigen könnte. Verwenden Oder AppendChild die Methoden und insertCell Methoden auf der nicht verwalteten IHTMLTable Schnittstelle, um Zeilen und Zellen zu einer TABLEhinzuzufügen.insertRow

Wenn Sie einem Element nur Text und nicht einem HTML-Markup zuweisen müssen, verwenden Sie stattdessen die InnerText Eigenschaft.

Durch das Zuweisen eines Werts InnerHtml werden alle Zuvor zugewiesenen Textwerte zerstört InnerText.

Gilt für:

Weitere Informationen