Xml.XMLDoc.TXMLDocument.Active
Delphi
property Active: Boolean read GetActive write SetActive default False;
C++
__property bool Active = {read=GetActive, write=SetActive, default=0};
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| property | published | Xml.XMLDoc.pas Xml.XMLDoc.hpp |
Xml.XMLDoc | TXMLDocument |
Description
Spécifie si le document XML a été analysé de telle sorte que les interfaces DOM autorisent l'examen ou la modification de son contenu.
Avant d'utiliser TXMLDocument pour examiner ou modifier le contenu d'un document XML, il doit être actif. Lorsque Active a la valeur true, TXMLDocument effectue les opérations suivantes :
1. Il génère un événement BeforeOpen.
2. Si nécessaire, il charge l'analyseur DOM et définit la propriété DOMImplementation.
3. Il analyse le document XML spécifié par FileName ou, si FileName est une chaîne vide, par la propriété XML à l'aide des options spécifiées par ParseOptions. Si FileName et XML sont des chaînes vides, TXMLDocument crée un document vide. L'interface du document analysé est affectée à la propriété DOMDocument.
4. Il génère un événement AfterOpen.
Remarque : Une fois que la propriété DOMDocument est définie, vous pouvez également utiliser la propriété DocumentElement.
Lorsque Active a la valeur false, TXMLDocument effectue les opérations suivantes :
1. Il génère un événement BeforeClose.
2. Il libère toutes les interfaces DOM, telles que DOMDocument et DocumentElement, qui représentent le document XML analysé.
3. Il génère un événement AfterClose.