Xml.XMLIntf.IXMLNode.Attributes
Delphi
property Attributes[const AttrName: DOMString]: OleVariant read GetAttribute write SetAttribute;
C++
__property System::OleVariant Attributes[const System::UnicodeString AttrName] = {read=GetAttribute, write=SetAttribute};
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| property | public | Xml.XMLIntf.pas Xml.XMLIntf.hpp |
Xml.XMLIntf | IXMLNode |
Beschreibung
Repräsentiert die Attributwerte für den Knoten.
Mit Hilfe von Attributes können Sie die Werte der Attribute des Knotens lesen oder festlegen. Über die Attributes kann ein Knoten in einem XML-Dokument geändert werden. Ein Beispiel:
<Movie genre="scifi" title="Star Wars"> ... </Movie>
genre und title sind in diesem Fall Attribute des Knotens, hier mit den Werten "scifi" und "Star Wars".
Im Index AttrName wird der Name des Attributs angegeben, auf das zugegriffen werden soll. Im obigen Beispiel sind genre und title die Attributnamen. Wenn Sie bei einem Schreibzugriff auf die Eigenschaft Attributes den Namen eines vorhandenen Attributs angeben, wird der Wert dieses Attributs geändert. Existiert dagegen kein Attribut mit dem angegebenen Namen, wird ein neues Attribut für den Knoten erzeugt.
Wenn Sie bei einem Lesezugriff auf die Eigenschaft Attributes einen Attributnamen angeben, der für den Knoten nicht existiert, ist der zurückgegebene Wert von der Eigenschaft Options des Dokuments abhängig, das den Knoten enthält. Wenn Options den Wert doAttrNull enthält, führt der Lesezugriff auf ein nicht vorhandenes Attribut zur Rückgabe einer Null-Variante. Ist der Wert doAttrNull nicht in Options enthalten, wird ein leerer String zurückgegeben.
Der Wert von Attributes besteht aus dem Text des angegebenen Attributs. Beim Festlegen von Attributen wird der Wertstring nicht analysiert. Markups im übergebenen Wert (z. B. Entitätsreferenz) werden als Literal interpretiert. Wenn Sie ein Attribut auf nil (Delphi) bzw. NULL (C++) setzen, wird es aus dem Knoten entfernt. Es ist möglich, einem Attribut einen leeren String als Wert zuzuweisen.