Interface XmlNode

This interface describes methods and properties available to work with xml nodes.

Methods

Return Type	Signature
XmlNode	AppendChild( XmlNode newChild)
string	GetAttribute( string name)
XmlNode	GetAttributeNode( string name)
void	GetAttributeNS( string namespaceURI, string localName)
string	GetXML()
boolean	HasAttributes()
boolean	HasChildNodes()
XmlNode	InsertBefore( XmlNode newChild, XmlNode refChild)
XmlNodeList	Query( string xpath)
void	RemoveAttribute( string name)
void	RemoveAttributeNS( string namespaceURI, string localName)
XmlNode	RemoveChild( XmlNode oldChild)
XmlNode	ReplaceChild( XmlNode newChild, XmlNode oldChild)
void	SetAttribute( string name, string value)
void	SetAttributeNS( string namespaceURI, string qualifiedName, string value)

Properties

Type	Property
XmlNodeList	attributes
XmlNodeList	childnodes
XmlNode	firstchild
XmlNode	lastchild
string	namespaceuri
XmlNode	nextsibling
string	nodename
integer	nodetype
string	nodevalue
XmlDocument	ownerdocument
XmlNode	parentnode
string	prefix
XmlNode	previoussibling
string	textcontent

Methods

AppendChild

Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.

XmlNode AppendChild(
XmlNode newChild)

Name	Description
newChild	The node to add.

GetAttribute

Retrieves an attribute value by name.
To retrieve an attribute value with a qualified name and namespace URI, use the getAttributeNS method.

string GetAttribute(
string name)

Name	Description
name	The name of the attribute to retrieve.

GetAttributeNode

Retrieves an attribute node by name.
To retrieve an attribute node by qualified name and namespace URI, use the GetAttributeNodeNS method.

XmlNode GetAttributeNode(
string name)

Name	Description
name	The `nodeName` of the attribute to retrieve.

GetAttributeNS

Retrieves an attribute value by local name and namespace URI.

void GetAttributeNS(
string namespaceURI,
string localName)

Name	Description
namespaceURI	The namespace URI of the attribute to retrieve.
localName	The qualified name of the attribute to retrieve.

GetXML

Returns the XML representation of the XmlNode.

string GetXML()

HasAttributes

Returns whether this node (if it is an element) has any attributes.

boolean HasAttributes()

HasChildNodes

Returns whether this node has any children.

boolean HasChildNodes()

InsertBefore

Inserts the node newChild before the existing child node refChild and returns it. If refChild is null, insert newChild at the end of the list of children.
If the newChild is already in the tree, it is first removed.

XmlNode InsertBefore(
XmlNode newChild,
XmlNode refChild)

Name	Description
newChild	The node to insert.
refChild	The reference node, i.e., the node before which the new node must be inserted.

Query

Returns an XmlNodeList of all the XmlNodes matching a given XPath and contained in the node.

XmlNodeList Query(
string xpath)

Name	Description
xpath	The XPath which is evaluated to get the `XmlNode`s.

RemoveAttribute

Removes an attribute by name. If a default value for the removed attribute is defined in the DTD, a new attribute immediately appears with the default value as well as the corresponding namespace URI, local name, and prefix when applicable.
If no attribute with this name is found, this method has no effect.
To remove an attribute by local name and namespace URI, use the RemoveAttributeNS method.

void RemoveAttribute(
string name)

Name	Description
name	The name of the attribute to remove.

RemoveAttributeNS

Removes an attribute by local name and namespace URI. If no attribute with this local name and namespace URI is found,this method has no effect.

void RemoveAttributeNS(
string namespaceURI,
string localName)

Name	Description
namespaceURI	The namespace URI of the attribute to retrieve.
localName	The local name of the attribute to retrieve.

RemoveChild

Removes the child node indicated by oldChild from the list of children, and returns it.

XmlNode RemoveChild(
XmlNode oldChild)

Name	Description
oldChild	The node being removed.

ReplaceChild

Replaces the child node oldChild with newChild in the list of children, and returns the oldChild node.
If the newChild is already in the tree, it is first removed.

XmlNode ReplaceChild(
XmlNode newChild,
XmlNode oldChild)

Name	Description
newChild	The new node to put in the child list.
oldChild	The node being replaced in the list.

SetAttribute

Adds a new attribute. If an attribute with that name is already present in the element, its value is changed to be that of the value parameter. This value is a simple string; it is not parsed as it is being set. So any markup (such as syntax to be recognized as an entity reference) is treated as literal text, and needs to be appropriately escaped by the implementation when it is written out. In order to assign an attribute value that contains entity.
To set an attribute with a qualified name and namespace URI, use the SetAttributeNS method.

void SetAttribute(
string name,
string value)

Name	Description
name	The name of the attribute to create or alter.
value	Value to set in string form.

SetAttributeNS

Adds a new attribute with a namespace and a prefix. If an attribute with that name is already present in the element, its value is changed to be that of the value parameter. This value is a simple string; it is not parsed as it is being set. So any markup (such as syntax to be recognized as an entity reference) is treated as literal text, and needs to be appropriately escaped by the implementation when it is written out. In order to assign an attribute value that contains entity.

void SetAttributeNS(
  string namespaceURI,
  string qualifiedName,
  string value)

Name	Description
namespaceURI	The namespace URI of the attribute to set.
qualifiedName	The qualified name of the attribute to set.
value	Value to set in string form.

Properties

attributes

An XmlNodeList containing the attributes of this node or null otherwise.

XmlNodeList attributes readonly

childnodes

An XmlNodeList that contains all children of this node. If there are no children, this is an XmlNodeList containing no nodes.

XmlNodeList childnodes readonly

firstchild

The first child of this node. If there is no such node, this returns null

XmlNode firstchild readonly

lastchild

The last child of this node. If there is no such node, this returns null.

XmlNode lastchild readonly

namespaceuri

The namespace URI of this node, or null if it is unspecified (see ).
This is not a computed value that is the result of a namespace lookup based on an examination of the namespace declarations in scope. It is merely the namespace URI given at creation time.

string namespaceuri readonly

nextsibling

The node immediately following this node. If there is no such node, this returns null.

XmlNode nextsibling readonly

nodename

The name of this node.

string nodename readonly

nodetype

A code representing the type of the underlying object.

integer nodetype

nodevalue

The value of this node.

string nodevalue

ownerdocument

The XmlDocument owning the node.

XmlDocument ownerdocument readonly

parentnode

The parent of this node. If a node has just been created and not yet added to the tree, or if it has been removed from the tree, this is null.

XmlNode parentnode readonly

prefix

The namespace prefix of this node, or null if it is unspecified.

string prefix readonly

previoussibling

The node immediately preceding this node. If there is no such node, this returns null.

XmlNode previoussibling readonly

textcontent

This attribute returns the text content of this node and its descendants.

string textcontent