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. Однако вы также не можете задать InnerHtmlTABLE значение и TR элементы, так как назначение неправильно сформированного HTML для этих элементов может повредить отрисовку документа. Используйте AppendChild или insertRowinsertCell методы в неуправляемом IHTMLTable интерфейсе для добавления строк и ячеек в объект TABLE.
Если вам нужно назначить текст элементу, а не разметке HTML, используйте InnerText это свойство.
Назначение значения для InnerHtml уничтожения любых текстовых значений, назначенных ранее с помощью InnerText.
