XMLDocument  - AS3

Показывает сведения об объявлении DOCTYPE для XML-документа. После разбора текста XML и преобразования его в объект XMLDocument свойство XMLDocument.docTypeDecl объекта XMLDocument получает текст объявления DOCTYPE XML-документа (например, <!DOCTYPE greeting SYSTEM "hello.dtd">). Это свойство задается с помощью строкового представления объявления DOCTYPE, а не с помощью объекта XMLNode.

Синтаксический анализатор XML, встречающийся в предыдущих версиях ActionScript, не проверяет достоверность документа. Объявление DOCTYPE считывается анализатором и сохраняется в свойстве XMLDocument.docTypeDecl, но проверка описания типа документа (DTD) при этом не выполняется.

Если в ходе разбора не удается обнаружить объявление DOCTYPE, свойство XMLDocument.docTypeDecl принимает значение null. Метод XML.toString() выводит содержимое XML.docTypeDecl сразу после XML-объявления, сохраняемого в XML.xmlDecl, и перед любым другим текстом в объекте XML. Если XMLDocument.docTypeDecl имеет значение null, объявление DOCTYPE не выводится.

Объект, содержащий узлы XML, которым присвоен атрибут id. Имена свойств объекта (каждое из которых содержит узел) совпадают со значениями атрибутов id.

Рассмотрим следующий объект XMLDocument:

     <employee id='41'>
         <name>
             John Doe
         </name>
         <address>
             601 Townsend St.
         </address>
     </employee>
     
     <employee id='42'>
         <name>
             Jane Q. Public
         </name>
     </employee>
     <department id="IT">
         Information Technology
     </department>
     

В данном примере свойство idMap объекта XMLDocument является объектом с тремя свойствами: 41, 42 и IT. Каждое из этих свойств является объектом XMLNode с подходящим значением id. Например, свойство IT объекта idMap является этим узлом:

     <department id="IT">
         Information Technology
     </department>
     

Для создания экземпляра свойства idMap к объекту XMLDocument необходимо применить метод parseXML().

Если объектов XMLNode с одинаковым значением id более одного, подходящим свойством объекта idNode будет это же свойство последнего разобранного узла. Например:

     var x1:XML = new XMLDocument("<a id='1'><b id='2' /><c id='1' /></a>");
     x2 = new XMLDocument();
     x2.parseXML(x1);
     trace(x2.idMap['1']);
     

     <c id='1' />
     

Если установлено значение true, текстовые узлы, содержащие только пробелы, при разборе игнорируются. Текстовые узлы, начинающиеся или заканчивающиеся пробелом, не затрагиваются. Параметр по умолчанию — false.

Можно назначить свойство ignoreWhite отдельным объектам XMLDocument, как показано в примере:

     my_xml.ignoreWhite = true;
     

Строка, задающая информацию о XML-объявлении в документе. После разбора XML-документа и преобразования в объект XMLDocument то свойство устанавливается для XML-объявления в документе. Это свойство задается с помощью строкового представления XML-объявления, а не с помощью объекта XMLNode. Если в ходе разбора не удается обнаружить XML-объявление, свойство принимает значение null. Метод XMLDocument.toString() выводит содержимое свойства XML.xmlDecl выше любого другого текста объекта XML. Если свойство XML.xmlDecl содержит значение null, XML-объявление не выводится.

Создает новый объект XMLDocument. Для создания объекта XMLDocument следует использовать конструктор, прежде чем вызывать какие-либо методы класса XMLDocument.

Примечание. Пользуйтесь методами createElement() и createTextNode() для добавления элементов и текстовых узлов в дерево XML-документа.

Связанные элементы API

Создает новый объект XMLNode с именем, заданным параметром. Для нового узла изначально не существует родительских и дочерних узлов и родственных элементов того же уровня. Метод возвращает ссылку на вновь созданный объект XMLNode, которым представлен элемент. Этот метод и метод XMLDocument.createTextNode() являются методами-конструкторами для создания узлов объекта XMLDocument.

Параметры

Связанные элементы API

Создает новый текстовый узел XML с заданным текстом. Для нового узла изначально не существует родительских узлов, а у текстового узла не может быть дочерних узлов или родственных элементов того же уровня. Этот метод возвращает ссылку на объект XMLDocument, которым представлен текстовый узел. Этот метод и метод XMLDocument.createElement() являются методами-конструкторами для создания узлов объекта XMLDocument.

Параметры

Связанные элементы API

Разбирает текст XML, указанный в параметре value, и формирует в объекте XMLDocument получившееся дерево XML. Все существующие деревья в объекте XMLDocument отбрасываются.

Параметры

Возвращает строковое представление объекта XML.