XMLDocument  - AS3

Spécifie des informations sur la déclaration DOCTYPE du document XML. Après analyse du texte XML dans un objet XMLDocument, la propriété XMLDocument.docTypeDecl de l’objet XMLDocument est définie sur le texte de la déclaration DOCTYPE du document XML (par exemple <!DOCTYPE greeting SYSTEM "hello.dtd">). Cette définition s’effectue à l’aide d’une représentation sous forme de chaîne de la déclaration DOCTYPE, pas d’un objet XMLNode.

L’ancien programme d’analyse XML ActionScript n’est pas un programme d’analyse de validation. La déclaration DOCTYPE est lue par le programme d’analyse et enregistrée dans la propriété XMLDocument.docTypeDecl, mais aucune validation DTD n’est effectuée.

En cas d’absence de déclaration DOCTYPE au cours d’une opération d’analyse, la propriété XMLDocument.docTypeDecl est définie sur null. La méthode XML.toString() produit le contenu de XML.docTypeDecl immédiatement après la déclaration XML enregistrée dans XML.xmlDecl, et avant tout autre texte dans l’objet XML. Si XMLDocument.docTypeDecl est null, aucune déclaration DOCTYPE n’est produite.

Objet contenant les nœuds du fichier XML auxquels un attribut id a été attribué. Les noms des propriétés de l’objet (contenant un nœud chacune) correspondent aux valeurs des attributs id.

Considérez l’objet XMLDocument suivant :

     <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>
     

Dans cet exemple, la propriété idMap de cet objet XMLDocument est un objet avec trois propriétés : 41, 42 et IT. Chacune de ces propriétés est un objet XMLNode avec la valeur id correspondante. Par exemple, la propriété IT de l’objet idMap est ce nœud :

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

Vous devez utiliser la méthode parseXML() sur l’objet XMLDocument pour la propriété idMap à instancier.

Si plusieurs objets XMLNode ont la même valeur id, la propriété correspondante de l’objet idNode est celle du dernier nœud analysé. Par exemple :

     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' />
     

Lorsque la propriété est réglée sur true, les nœuds de texte qui ne contiennent que des espaces blancs sont supprimés au cours de l’analyse. Les nœuds de texte qui contiennent un espace blanc à gauche ou à droite ne sont pas affectés. Le paramètre par défaut est false.

Vous pouvez définir la propriété ignoreWhite des objets XMLDocument individuels, comme indiqué par le code suivant :

     my_xml.ignoreWhite = true;
     

Chaîne qui spécifie des informations sur la déclaration XML d’un document. Après l’analyse du document XML dans un objet XMLDocument, cette propriété est définie sur le texte de la déclaration XML du document. Cette définition s’effectue à l’aide d’une représentation sous forme de chaîne de la déclaration XML, pas d’un objet XMLNode. En cas d’absence de déclaration XML au cours d’une opération d’analyse, la propriété est définie sur null. La méthode XMLDocument.toString() fournit le contenu de la propriété XML.xmlDecl avant tout autre texte de l’objet XML. Si la propriété XML.xmlDecl contient null, aucune déclaration XML n’est produite.

Crée un objet XMLDocument. Vous devez utiliser le constructeur pour créer un objet XMLDocument avant d’appeler les méthodes de la classe XMLDocument.

Remarque : utilisez les méthodes createElement() et createTextNode() pour ajouter des éléments et des nœuds de texte à une arborescence de documents XML.

Eléments de l’API associés

Crée un objet XMLNode doté du nom spécifié dans le paramètre. Le nouveau nœud n’a initialement pas de parent, pas d’enfants et pas de frères. La méthode renvoie une référence au nouvel objet XMLNode créé qui représente l’élément. Cette méthode et la méthode XMLDocument.createTextNode() représentent les méthodes constructeur utilisées lors de la création de nœuds d’un objet XMLDocument.

Paramètres

Eléments de l’API associés

Crée un nœud de texte XML en utilisant le texte spécifié. Le nouveau nœud n’a initialement pas de parent et les nœuds de texte ne peuvent pas avoir d’enfants ni de frères. Cette méthode renvoie une référence à l’objet XMLDocument qui représente le nouveau nœud de texte. Cette méthode et la méthode XMLDocument.createElement() représentent les méthodes constructeur utilisées lors de la création de nœuds d’un objet XMLDocument.

Paramètres

Eléments de l’API associés

Analyse le texte XML spécifié dans le paramètre value et renseigne l’objet XMLDocument spécifié avec l’arborescence XML obtenue. Toutes les arborescences existantes dans l’objet XMLDocument sont supprimées.

Paramètres

Renvoie l’objet XML sous forme de chaîne.