Xml.XMLDoc.TXMLDocument.Options
Delphi
property Options: TXMLDocOptions read GetOptions write SetOptions default [doNodeAutoCreate, doAttrNull, doAutoPrefix, doNamespaceDecl];
C++
__property Xml::Xmlintf::TXMLDocOptions Options = {read=GetOptions, write=SetOptions, default=29};
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
property | published | Xml.XMLDoc.pas Xml.XMLDoc.hpp |
Xml.XMLDoc | TXMLDocument |
Beschreibung
Beeinflusst verschiedene Aspekte des Dokumentverhaltens.
Mit Options können Sie festlegen, welche Operationen durchgeführt werden, wenn nicht vorhandene Knoten oder Attribute gelesen werden, ein neuer Namespace für einen Knoten erstellt oder XML-Text aus den Knoten im Dokument generiert wird. Außerdem können Sie angeben, ob der Wert von Options beim Schließen des Dokuments automatisch gespeichert wird. Folgende Werte stehen zur Verfügung:
Wert | Bedeutung |
---|---|
doNodeAutoCreate |
Wenn auf einen Knoten über die Eigenschaft Nodes des Interface IXMLNodeList zugegriffen wird und der Name des Knotens nicht vorhanden ist, wird automatisch ein neuer Knoten mit dem angegebenen Namen erstellt. |
doNodeAutoIndent |
Beim Formatieren des XML-Textes aus den analysierten Knoten werden untergeordnete Knoten automatisch eingerückt. |
doAttrNull |
Wenn der Wert eines nicht vorhandenen Attributs gelesen werden soll, wird eine Null-Variante (anstelle eines Leerstrings) zurückgegeben. |
doAutoPrefix |
Die Namen neuer Knoten erhalten automatisch ein Namespace-Präfix, wenn ein Namespace-URI angegeben wird. |
doNamespaceDecl |
Wenn in der Methode AddChild ein Namespace für den Knoten erstellt werden muss, wird auch ein Attribut zum Deklarieren des neuen Namespace hinzugefügt. Ohne das Flag doNamespaceDecl erstellt die Methode zwar den neuen Namespace, fügt aber kein Deklarationsattribut hinzu. |
doAutoSave |
Beim Schließen des Dokuments (Active wird auf false gesetzt) werden alle Änderungen automatisch in der Eigenschaft XML oder in der mit der Eigenschaft FileName angegebenen Datei gespeichert. |