HtmlElement.InnerHtml Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví kód HTML pod tímto prvkem.
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
Hodnota vlastnosti
Kód HTML, který definuje podřízené prvky aktuálního elementu.
Výjimky
Vytváření podřízených prvků v tomto prvku není povoleno.
Poznámky
Existuje několik způsobů, jak přidat nové prvky na existující stránku HTML, jako jsou například metody AppendChild a InsertAdjacentElement metody. Použití InnerHtml je často nejrychlejší způsob, jak přidat nový obsah, když potřebujete nastavit mnoho atributů nebo stylů u nových prvků.
InnerHtml liší se od OuterHtml toho, že InnerHtml neobsahuje kód HTML, který představuje objekt, který voláte. Další OuterHtml informace o rozdílu mezi těmito dvěma vlastnostmi
Nastavení InnerHtml zničí všechny podřízené položky, které byly dříve připojeny k prvku. Pokud načtete prvek z MODELU DOM a pak přiřadíte nový HTML k jeho nadřazené vlastnosti InnerHtml , odkaz na tento prvek bude nepoužitelné a jeho chování při volání jeho vlastností a metod není definován.
U některých prvků InnerHtml nastavení není platná operace. Některé značky HTML nemají žádnou pravou značku, například IMG
značku, a proto nemohou obsahovat vnořené prvky. Některé značky, například SCRIPT
značka, můžou obsahovat pouze textový obsah. Nastavení InnerHtml způsobí chybu. U obou typů značek se CanHaveChildren vlastnost vrátí false
. Nelze však nastavit InnerHtml ani TABLE
TR
prvky, protože přiřazení poškozených HTML k těmto prvkům může poškodit vykreslování dokumentu. Použití AppendChild nebo insertRow
metody insertCell
v nespravovaném IHTMLTable
rozhraní k přidání řádků a buněk do TABLE
.
Pokud potřebujete pouze přiřadit text k elementu, a ne html značky, použijte místo toho InnerText vlastnost.
Přiřazení hodnoty k InnerHtml odstranění všech textových hodnot dříve přiřazených pomocí InnerText.