Xml.XMLDoc.TXMLNode.SetChildValue

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure SetChildValue(const IndexOrName: OleVariant; const Value: OleVariant);

C++

void __fastcall SetChildValue(const System::OleVariant &IndexOrName, const System::OleVariant &Value);

Properties

Type Visibility Source Unit Parent
procedure
function
protected
Xml.XMLDoc.pas
Xml.XMLDoc.hpp
Xml.XMLDoc TXMLNode

Description

Sets the value of a specified child node.

Use the TXMLNode object's IXMLNode interface to call the protected SetChildValue method. SetChildValue sets the value of a specified child node to a specified value.

IndexOrName identifies the desired child node by either its interface, or by a string that is the local name of the child node. If IndexOrName does not identify a child of this node, SetChildValue raises an exception.

Value is the value to assign. Its interpretation depends on the type of the child node, as indicated in the following table:



NodeType Value

ntAttribute

The attribute value

ntElement

If the element contains only text, this is that text value. Otherwise, SetChildValue raises an exception.

ntText

The text

ntCData

The content of the CDATA section.

ntProcessingInstr

The content of the processing instruction except for the target.

ntComment

The value (text) of the comment.

If the child node is any other node type, SetChildValue raises an exception.



Note: Attributes are not considered child nodes of a node. To set the values of this node's attributes, use the SetAttribute method instead.

See Also