HtmlElement.InnerHtml HtmlElement.InnerHtml HtmlElement.InnerHtml HtmlElement.InnerHtml Property

定義

この要素の下位にある HTML マークアップを取得または設定します。Gets or sets the HTML markup underneath this element.

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

プロパティ値

現在の要素の子要素を定義する HTML マークアップ。The HTML markup that defines the child elements of the current element.

例外

この要素では子要素を作成できません。Creating child elements on this element is not allowed.

注釈

メソッドAppendChildInsertAdjacentElementメソッドなど、既存の HTML ページに新しい要素を追加するには、いくつかの方法があります。There are several ways to add new elements to an existing HTML page, such as the AppendChild and InsertAdjacentElement methods. 新しいInnerHtml要素に多くの属性またはスタイルを設定する必要がある場合は、を使用すると、新しいコンテンツをすばやく追加できます。Using InnerHtml is often the fastest way to add new content when you have to set many attributes or styles on your new elements.

InnerHtmlは、呼び出してInnerHtmlいるオブジェクトを表す HTML を含まないのとは異なります。OuterHtmlInnerHtml differs from OuterHtml in that InnerHtml will not include the HTML that represents the object you are calling. これらOuterHtml 2 つのプロパティの違いの詳細については、「」を参照してください。See OuterHtml for more information about the difference between these two properties.

InnerHtml設定すると、以前に要素に追加されたすべての子が破棄されます。Setting InnerHtml destroys any children previously appended to the element. DOM から要素を取得し、その親のInnerHtmlプロパティに新しい HTML を割り当てると、その要素への参照は役に立たなくなり、プロパティとメソッドを呼び出すときの動作は未定義になります。If you retrieve an element from the DOM and then assign new HTML to its parents' InnerHtml property, your reference to that element will be useless, and its behavior when it calls its properties and methods is undefined.

一部の要素ではInnerHtml 、設定は有効な操作ではありません。For some elements, setting InnerHtml is not a valid operation. 一部の HTML タグには、 IMGタグなどの終了タグがないため、入れ子になった要素を含めることはできません。Some HTML tags have no closing tag, such as the IMG tag, and therefore cannot contain nested elements. SCRIPTタグなどの一部のタグには、テキストコンテンツのみを含めることInnerHtmlができます。設定すると、エラーが発生します。Some tags, such as the SCRIPT tag, can only contain text content; setting InnerHtml will result in an error. どちらの種類のタグでもCanHaveChildren 、プロパティはfalseを返します。For both types of tags, the CanHaveChildren property will return false. ただし、要素InnerHtml TABLETR要素にを設定することはできません。これらの要素に正しくない形式の HTML を割り当てると、ドキュメントのレンダリングが破損する可能性があります。However, you also cannot set InnerHtml on TABLE and TR elements, as assigning malformed HTML to these elements could corrupt the rendering of the document. アンAppendChildマネージinsertCell insertRow TABLEインターフェイスでまたはメソッドを使用して、に行とセルを追加します。 IHTMLTableUse AppendChild or the insertRow and insertCell methods on the unmanaged IHTMLTable interface to add rows and cells to a TABLE.

HTML マークアップではなく、要素へのテキストのInnerText割り当てのみが必要な場合は、代わりにプロパティを使用します。If you need only to assign text to an element and not HTML markup, use the InnerText property instead.

に値を割り当てるInnerHtmlと、を使用してInnerText以前に割り当てられたすべてのテキスト値が破棄されます。Assigning a value to InnerHtml will destroy any text values previously assigned using InnerText.

適用対象

こちらもご覧ください