2.2.1. Объект IXMLDOMDocument

Объект IXMLDOMDocument представляет узел Document. Данный узел всегда является корневым узлом дерева и представляет документ в целом. Создание этого объекта в программе возлагается на пользователя. Как создается этот объект с использованием различных языков программирования дано в разделе 2.1.2.

 

Данный объект наследуется от IXMLDOMNode.

 

Свойство

Описание

Режим

async*

Показывает какой режим загрузки разрешен (см. раздел 2.1.4)

Ч / З

attributes

Содержит список атрибутов данного узла.

Ч

baseName*

Возвращает базовое имя элемента, входящее в квалифицированное имя. Квалифицированное имя - <xxx:yyy>, где xxx-имя, задающее область имен, yyy-базовое имя элемента.

Ч

childNodes

Для узлов, которые могут иметь дочерние элементы, возвращает объект IXMLDOMNodeList, содержащий список дочерних узлов. Если объект не имеет дочерних узл, то все равно объект IXMLDOMNodeList возвращается, однако его длина равна 0.

Ч

dataType*

Определяет тип данных для данного узла.

Ч / З

definition*

Возвращает описание узла в DTD или схеме.

Ч

doctype

Возвращает ссылку на узел NODE_DOCUMENT_TYPE, который определяет DTD. В случае, если DTD не задан, возвращается Null.

Ч

documentElement

Возвращает корневой элемент документа.

Ч / З

firstChild

Возвращает первый дочерний узел данного узла.

Ч

implementation

Возвращает объект IXMLDOMImplementation для данного документа. XML DOM приложение может использовать объекты от  различных реализаций. Это свойство обеспечивает доступ к объекту IXMLDOMImplementation, которое обрабатывает данный документ.[Script]

Script Syntax

var objXMLDOMImplementation = oXMLDOMDocument.implementation;

Example

The following script example creates an IXMLDOMImplementation object.

var xmlDoc = new ActiveXObject("Msxml2.DOMDocument");
var oImplementation;
xmlDoc.async = false;
xmlDoc.load("books.xml");
oImplementation = xmlDoc.implementation;

[Visual Basic]

Visual Basic Syntax

Set objXMLDOMImplementation = oXMLDOMDocument.implementation

Example

The following Microsoft® Visual Basic® example creates an IXMLDOMImplementation object.

Dim xmlDoc As New Msxml2.DOMDocument
Dim oImplementation As IXMLDOMImplementation
xmlDoc.async = False
xmlDoc.Load ("books.xml")
Set oImplementation = xmlDoc.implementation

 

Ч

lastChild

Возвращает последний дочерний узел от данного узла. Если дочерних узлов нет, возвращает Null.

Ч

namespaceURI*

Возвращает строку с URI для области имен. Если область имен задана как xmlns:nnn="uuu", то будет возвращаться "uuu".

Ч

nextSibling

Содержит следующий узел-брат данного узла в списке дочерних узлов родителя.

Ч

nodeName

Содержит квалифицированное имя элемента, атрибута, ссылки компонента или фиксированной строки для других типов узлов (см. табл.1, колонка Имя узла).

Ч

nodeType

Определяет числовое значение типа узла XML DOM (см. табл.1, колонка ID узла).

Ч

nodeTypedValue*

Содержит значение данного узла, выраженное в заданном для него типе данных.

Ч / З

nodeTypeString*

Возвращает тип узла в строковой форме.

Ч

nodeValue

Содержит текст, ассоциируемый с узлом.

Ч / З

ondataavailable*

Определяет обработчик событий для события ondataavailable.

Ч / З

onreadystatechange*

Определяет обработчик событий, вызываемый когда свойство readyState изменяется.

Ч / З

ontransformnode*

Определяет обработчик событий для события ontransformnode.

Ч / З

ownerDocument

Возвращает корень документа, в котором содержится данный узел.

Ч

parentNode

Содержит родительский узел (для узлов, которые имеют родителей).

Ч

parsed*

Содержит True, если данный узел и все потомки успешно обработаны анализатором; False в противном случае.

Ч

parseError*

Возвращает объект IXMLDOMParseError, который содержит информацию о последней ошибке при анализе (см. раздел 2.1.5.).

Ч

prefix*

Возвращает префикс области имен.

Ч

preserveWhiteSpace*

Содержит True, если надо сохранять пустое пространство; False в противном случае. По умолчанию False.

Ч / З

previousSibling

Содержит первый (левый) элемент брат для данного узла.

Ч

readyState*

Показывает текщее состояние XML документа (см. раздел 2.1.4.).

Ч

resolveExternals*

Показывает независимые внешние определения (разрешенные области имен, внешние поднаборы DTD и внешние определения сущностей) разрешенные во время анализа,  независимые от проверки.

Ч / З

specified*

Показывает независимые узлы (обычно атрибуты) точно заданные или произведенные из значений по умолчанию в DTD или схеме.

Ч

text*

Содержит текстовое содержание узла и его поддеревьев.

Ч / З

url*

Возвращает канонический URL для последнего загруженного XML документа.

Ч

validateOnParse*

Показывает – должен ли анализатор проводить проверку документа на его состоятельность. Если True, то должен, если False, то документ проверяется только на правильность. По умолчанию True.

Ч / З

xml*

Содержит XML представление узла и всех его потомков.

Ч

Символом "*" отмечены свойства, которые являются расширением спецификации World Wide Web Consortium (W3C) DOM.

Методы

abort*

Прерывает асинхронный процесс загрузки.

appendChild

Добавляет новый дочерний узел как последний (в конец списка) дочерний узел данного узла.

cloneNode

Создает новый узел, который является точной копией данного узла.

createAttribute

Создает новый узел атрибут с указанным именем.

createCDATASection

Создает узел CDATA section, который содержит указанные данные.

createComment

Создает узел комментарий, который содержит указанные данные.

createDocumentFragment

Создает пустой объект DocumentFragment.

createElement

Создает узел Element с заданным именем.

createEntityReference

Создает новый объект EntityReference.

createNode*

Создает узел, используя указанный тип, имя и пространство имен.

createProcessingInstruction

Создает узел processing instruction, который содержит указанную цель и данные.

createTextNode

Создает узел text, который содержит указанные данные.

getElementsByTagName

Возвращает коллекцию элементов, которые имеют указанное имя.

hasChildNodes

Возвращает True, если узел имеет дочерние узлы.

insertBefore

Вставляет дочерний узел перед (слева) заданным узлом или в конец списка, если не задан узел, перед которым нужно сделать вставку.

load*

Занружает XML документ по указанному местоположению (см. раздел 2.1.3.).

loadXML*

Загружает XML документ, используя заданную строку.

nodeFromID*

Возвращает узел, иденификатор ID которого соответствует заданному значению.

removeChild

Удаляет указанный дочерний узел из списка дочерний узлов и возвращает его.

replaceChild

Заменяет указанный старый дочерний узел на новый в наборе дочерний узлов радительского узла и возвращает старый дочерний узел.

save*

Сохраняет XML документ по заданому местоположению (см. раздел 2.1.7.).

selectNodes*

Применяет к контексту данного узла обработку по шаблону и возвращает список отобраннх узлов.

selectSingleNode*

Применяет к контексту данного узла обработку по шаблону и возвращает первый отобранный узел.

transformNode*

Обрабатывает данный узел и его дочерние узлы, используя листы стилей (XSLT), и возвращает результат преобразований.

transformNodeToObject*

Обрабатывает данный узел и его дочерние узлы, используя заданные листы стилей (XSLT)и возвращает результирующее преобразование в заданный объект.

Символом "*" отмечены свойства, которые являются расширением спецификации World Wide Web Consortium (W3C) DOM.

События

ondataavailable*

Показывает, что данные XML документа доступны.

onreadystatechange*

Происходит, когда изменяется свойство readyState.

ontransformnode*

Происходит перед тем, как каждый узел в листе стилей применяется к каждому узлу в исходном  XML. Событие ontransformnode не происходит для DOMDocument в случае, когда листы стилей используют пространство имен XSLThttp://www.w3.org/1999/XSL/Transform. Однако, если используется пространство имен XLST http://www.w3.org/TR/WD-xsl , то событие для DOMDocument происходит.

Символом "*" отмечены свойства, которые являются расширением спецификации World Wide Web Consortium (W3C) DOM.

Используются технологии uCoz