Xml.XMLDoc.TXMLDocument.Active
Delphi
property Active: Boolean read GetActive write SetActive default False;
C++
__property bool Active = {read=GetActive, write=SetActive, default=0};
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| property | published | Xml.XMLDoc.pas Xml.XMLDoc.hpp |
Xml.XMLDoc | TXMLDocument |
Beschreibung
Gibt an, ob das XML-Dokument analysiert wurde und die DOM-Schnittstellen für die Überprüfung oder Änderung des Inhalts verfügbar sind.
Bevor der Inhalt eines XML-Dokuments mittels IXMLDocument geprüft oder geändert werden kann, müssen Sie das Dokument aktivieren. Wenn Sie Active auf true setzen, werden folgende Operationen ausgeführt:
1. Das Ereignis BeforeOpen wird generiert.
2. Der DOM-Parser wird bei Bedarf geladen und der Eigenschaft DOMImplementation zugewiesen.
3. Das in FileName (oder XML, wenn FileName leer ist) angegebene XML-Dokument wird analysiert. Dabei werden die in der Eigenschaft ParseOptions definierten Optionen verwendet. Enthalten FileName und XML Leerstrings, wird automatisch ein leeres Dokument erstellt. Die Schnittstelle für das eingelesene Dokument wird der Eigenschaft DOMDocument zugewiesen.
4. Ein AfterOpen-Ereignis wird generiert.
Anmerkung: Wenn DOMDocument zugewiesen ist, können Sie auch die Eigenschaft DocumentElement verwenden.
Wenn Sie Active auf false setzen, werden folgende Operationen ausgeführt:
1. Das Ereignis BeforeClose wird generiert.
2. Alle DOM-Schnittstellen (z.B. DOMDocument und DocumentElement) des analysierten XML-Dokument werden freigegeben.
3. Das Ereignis AfterClose wird generiert.