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, setPublic 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.