HtmlElement.InnerHtml プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この要素の下位にある HTML マークアップを取得または設定します。
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 Stringプロパティ値
現在の要素の子要素を定義する HTML マークアップ。
例外
この要素に子要素を作成することはできません。
注釈
既存の HTML ページに新しい要素を追加する方法はいくつかあります(例: メソッドAppendChildInsertAdjacentElement)。 多くの場合、新しい要素に多くの属性やスタイルを設定する必要がある場合は、新しいコンテンツを追加する最も高速な方法が使用 InnerHtml されます。
InnerHtmlOuterHtmlは、呼び出しているオブジェクトを表す HTML が含まれていない点InnerHtmlで異なります。 これら 2 つのプロパティの違いの詳細については、以下を参照してください OuterHtml 。
設定 InnerHtml すると、以前に要素に追加されたすべての子が破棄されます。 DOM から要素を取得し、その親の InnerHtml プロパティに新しい HTML を割り当てると、その要素への参照は役に立たず、プロパティとメソッドを呼び出したときの動作は未定義になります。
一部の要素では、設定 InnerHtml が有効な操作ではありません。 一部の HTML タグには、タグなどの IMG 終了タグがないため、入れ子になった要素を含めることはできません。 タグなど、一部のタグには SCRIPT テキスト コンテンツのみを含めることができます。設定 InnerHtml するとエラーが発生します。 両方の種類のタグのCanHaveChildren場合、プロパティは .false ただし、 InnerHtml これらの要素に TABLE 形式が正しくない HTML を割り当てると TR 、ドキュメントのレンダリングが破損する可能性があります。 アンマネージド IHTMLTable インターフェイスでinsertRow行とinsertCellセルを追加する場合は、次のメソッドを使用またはメソッドをTABLE使用AppendChildします。
HTML マークアップではなく要素にテキストを割り当てる必要がある場合は、代わりにプロパティを InnerText 使用します。
値を割り当てると、以前に InnerHtml 割り当てた InnerTextテキスト値が破棄されます。