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};
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| property | public | Xml.XMLIntf.pas Xml.XMLIntf.hpp |
Xml.XMLIntf | IXMLNode |
Description
Représente les valeurs des attributs de ce noeud.
Attributes permet de lire ou de définir les valeurs des attributs de ce noeud. Attributes modifie un noeud dans un document XML. Par exemple, soit le noeud :
<Movie genre="scifi" title="Star Wars"> ... </Movie>
le genre et le titre sont des attributs du noeud, de valeur respective "scifi" et "Star Wars".
L'indice AttrName donne le nom de l'attribut auquel accéder. Dans l'exemple précédent, "genre" et "title" correspondent au nom des attributs. Lors de la définition de Attributes, si vous indiquez le nom d'un attribut qui existe déjà pour un noeud, vous modifiez la valeur de cet attribut. Si vous indiquez le nom d'un attribut qui ne correspond à aucun attribut du noeud, un nouvel attribut est créé.
Lors de la lecture de Attributes, si vous indiquez le nom d'un attribut qui n'existe pas pour le noeud, la valeur dépend de la propriété Options du document qui contient le noeud. Si Options contient doAttrNull, la lecture d'un attribut qui n'existe pas pour le noeud entraîne un Variant Null. Si Options ne contient pas doAttrNull, la lecture d'un attribut qui n'existe pas entraîne une chaîne vide.
La valeur de Attributes correspond au texte de l'attribut spécifié. Quand vous définissez des attributs, la chaîne de la valeur n'est pas analysée. Toutes les balises de la valeur fournie (par exemple, une référence d'entité) sont traitées comme du texte littéral. Si vous affectez la valeur nil (Delphi) ou NULL (C++) à un attribut, ce dernier est supprimé de ce noeud. Sachez toutefois que vous pouvez affecter une chaîne vide comme valeur d'un attribut.