HtmlElement.InnerHtml Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia znacznik HTML pod tym elementem.
public:
property System::String ^ InnerHtml { System::String ^ get(); void set(System::String ^ value); };public string InnerHtml { get; set; }member this.InnerHtml : string with get, setPublic Property InnerHtml As StringWartość właściwości
Znacznik HTML definiujący elementy podrzędne bieżącego elementu.
Wyjątki
Tworzenie elementów podrzędnych na tym elemecie jest niedozwolone.
Uwagi
Istnieje kilka sposobów dodawania nowych elementów do istniejącej strony HTML, takich jak AppendChild metody i InsertAdjacentElement . Użycie InnerHtml jest często najszybszym sposobem dodawania nowej zawartości, gdy trzeba ustawić wiele atrybutów lub stylów na nowych elementach.
InnerHtml różni się od OuterHtml tego, że InnerHtml nie będzie zawierać kodu HTML, który reprezentuje wywoływany obiekt. Aby uzyskać więcej informacji na temat różnic między tymi dwoma właściwościami, zobacz OuterHtml .
Ustawienie InnerHtml niszczy wszystkie elementy podrzędne, które zostały wcześniej dołączone do elementu. Jeśli pobierzesz element z modelu DOM, a następnie przypiszesz nowy kod HTML do właściwości rodziców InnerHtml , odwołanie do tego elementu będzie bezużyteczne, a jego zachowanie podczas wywoływania jego właściwości i metod jest niezdefiniowane.
W przypadku niektórych elementów ustawienie InnerHtml nie jest prawidłową operacją. Niektóre tagi HTML nie mają tagu IMG zamykającego, takiego jak tag, i dlatego nie mogą zawierać zagnieżdżonych elementów. Niektóre tagi, takie jak SCRIPT tag, mogą zawierać tylko zawartość tekstową; ustawienie InnerHtml spowoduje błąd. W przypadku obu typów tagów CanHaveChildren właściwość zwróci falsewartość . Nie można jednak również ustawić InnerHtml elementów TABLE i TR , ponieważ przypisanie źle sformułowanego kodu HTML do tych elementów może spowodować uszkodzenie renderowania dokumentu. Użyj AppendChild metod i insertCell lub insertRow w interfejsie niezarządzanymIHTMLTable, aby dodać wiersze i komórki do elementu TABLE.
Jeśli musisz przypisać tylko tekst do elementu, a nie znaczniki HTML, użyj InnerText właściwości .
Przypisanie wartości do InnerHtml spowoduje zniszczenie wszystkich wcześniej przypisanych wartości tekstowych przy użyciu polecenia InnerText.