Xml.XMLIntf.IXMLNode.ChildValues
Delphi
property ChildValues[const IndexOrName: OleVariant]: OleVariant read GetChildValue write SetChildValue; default;
C++
__property System::OleVariant ChildValues[const System::OleVariant IndexOrName] = {read=GetChildValue, write=SetChildValue/*, default*/};
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| property | public | Xml.XMLIntf.pas Xml.XMLIntf.hpp |
Xml.XMLIntf | IXMLNode |
Beschreibung
Repräsentiert die Werte der untergeordneten Knoten des Knotens.
Mit ChildValues können Sie auf die untergeordneten Knoten des Knotens zugreifen.
In IndexOrName wird der Name des gewünschten untergeordneten Knotens angegeben. Dabei kann entweder seine Schnittstelle oder sein lokaler Name verwendet werden. Wenn IndexOrName kein untergeordneter Knoten des Knotens ist, führt der Lese- oder Schreibzugriff auf ChildValues zu einer Exception.
Der Wert eines untergeordneten Knotens ist von seinem Typ (Eigenschaft NodeType) abhängig. Die möglichen Werte sind in der folgenden Tabelle aufgeführt.
| NodeType | Wert |
|---|---|
|
ntElement |
Der Textwert, wenn das Element nur Text enthält. Andernfalls wird der Wert des ersten untergeordneten Knotens verwendet. |
|
ntText |
Der Text des Knotens. |
|
ntCData |
Der Inhalt des CDATA-Abschnitts. |
|
ntProcessingInstr |
Der Inhalt der Verarbeitungsanweisung (nicht für das Ziel). |
|
ntComment |
Der Wert (Text) des Kommentars. |
|
Wenn der untergeordnete Knoten einen anderen Typ hat, führt der Lese- oder Schreibzugriff auf ChildValues zu einer Exception. |
Anmerkung: In Delphi ist ChildValues die Standardeigenschaft von IXMLNode. Bei Verwendung dieser Eigenschaft kann deshalb der Eigenschaftsname weggelassen werden. Zum Beispiel kann die Anweisung:
Edit1.Text := XMLDocument1.DocumentElement.ChildValues['Name'];
auch durch folgende Anweisung ersetzt werden:
Edit1.Text := XMLDocument1.DocumentElement['Name'];
Anmerkung: Attribute werden nicht als untergeordnete Knoten behandelt. Verwenden Sie zum Abrufen oder Festlegen der Attributwerte eines Knotens die Eigenschaft Attributes.