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

String

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

Ausnahmen

Das Erstellen von untergeordneten Elementen für dieses Element ist nicht zulässig.

Hinweise

Es gibt verschiedene Möglichkeiten, neue Elemente zu einer vorhandenen HTML-Seite 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 enthält, der das aufgerufene Objekt darstellt. Weitere Informationen zum Unterschied zwischen diesen beiden Eigenschaften finden Sie OuterHtml unter

Die Einstellung InnerHtml zerstört alle untergeordneten Elemente, die zuvor an das Element angefügt wurden. Wenn Sie ein Element aus dem DOM abrufen und dann derEn Elterneigenschaft neue HTML InnerHtml zuweisen, ist ihr Verweis auf dieses Element unbrauchbar und sein Verhalten, wenn er die Eigenschaften und Methoden aufruft, nicht definiert.

Für einige Elemente ist die Einstellung InnerHtml kein gültiger Vorgang. Einige HTML-Tags verfügen über kein schließende Tag, z. B. das IMG Tag und können daher 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 wird die CanHaveChildren Eigenschaft zurückgegeben false. Sie können jedoch auch nicht auf TABLE und TR Elemente festlegenInnerHtml, da das Zuweisen falscher HTML-Elemente zu diesen Elementen das Rendern des Dokuments beeinträchtigen könnte. Verwenden AppendChild Sie oder die insertCell insertRow Methoden für die nicht verwaltete IHTMLTable Schnittstelle, um Zeilen und Zellen zu einer TABLEhinzuzufügen.

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

Durch Zuweisen eines Werts werden InnerHtml alle zuvor zugewiesenen InnerTextTextwerte zerstört.

Gilt für

Siehe auch