HtmlElement.InnerHtml Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 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 TABLE
hinzuzufü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.