HtmlElement.InnerHtml Свойство
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает разметку 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, set
Public Property InnerHtml As String
Разметка HTML, определяющая дочерние элементы текущего элемента.
Создание дочерних элементов данного элемента не допускается.
Существует несколько способов добавления новых элементов на существующую HTML-страницу, например AppendChild методов и InsertAdjacentElement методов. Использование InnerHtml часто является самым быстрым способом добавления нового содержимого, если необходимо задать множество атрибутов или стилей для новых элементов.
InnerHtml отличается от OuterHtml того, что InnerHtml не будет включать HTML, представляющий вызываемый объект. Дополнительные сведения о различиях между этими двумя свойствами см OuterHtml . в статье.
Параметр InnerHtml удаляет все дочерние элементы, ранее добавленные к элементу. Если вы извлекаете элемент из модели DOM, а затем назначаете новый HTML свойству его родителей InnerHtml , ссылка на этот элемент будет бесполезным, а его поведение при вызове его свойств и методов не определено.
Для некоторых элементов параметр InnerHtml не является допустимой операцией. Некоторые ТЕГИ HTML не имеют закрывающего тега IMG
, например тега, и поэтому не могут содержать вложенные элементы. Некоторые теги, такие как SCRIPT
тег, могут содержать только текстовое содержимое; установка InnerHtml приведет к ошибке. Для обоих типов тегов CanHaveChildren возвращается false
свойство. Однако вы также не можете задать значение InnerHtml TABLE
и TR
элементы, так как назначение неправильно сформированного HTML для этих элементов может повредить отрисовку документа. Используйте AppendChild или insertRow
insertCell
методы в неуправляемом IHTMLTable
интерфейсе для добавления строк и ячеек в объект TABLE
.
Если вам нужно назначить текст элементу, а не разметке InnerText HTML, используйте это свойство.
При назначении значения InnerHtml будут уничтожены все текстовые значения, ранее назначенные с помощью InnerText.
Продукт | Версии |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
Windows Desktop | 3.0, 3.1, 5, 6, 7 |