IXMLDOMAttribute Object (C#)

The IXMLDOMAttribute object represents an attribute of the IXMLDOMElementIXMLDOMAttribute Object (C#). For more information, see the Microsoft XML SDK 3.0 documentation available at the Microsoft Web site.

The IXMLDOMAttribute object supports the following properties and methods for describing an IXMLDOMElement IXMLDOMElement Object (C#).

Property	Description
attributes	Contains the list of attributes for this node. Read-only.
childNodes	Contains a list of the children (for nodes that can have children). Read-only.
firstChild	Contains the first child of this node. Read-only.
lastChild	Contains the last child of this node. Read-only.
name	Contains the attribute name. Read-only.
nextSibling	Contains the next sibling of this node in the parent's child list. Read-only.
nodeName	Contains the qualified name of the element, attribute, or entity reference, or a fixed string for other node types. Read-only.
nodeType	Specifies the XML DOM node type, which determines valid values and whether the node can have child nodes. Read-only.
nodeTypeString*	Contains the node type in string form. Read-only.
nodeValue	Contains the text associated with the node. Read/write.
ownerDocument	Returns the root of the document that contains this node. Read-only.
parentNode	Contains the parent node (for nodes that can have parents). Read-only.
previousSibling	Contains the left sibling of this node. Read-only.
value	Contains the attribute value. Read/write.

*Denotes an extension to the W3C DOM.

Method	Description
appendChild	Appends the supplied new child as the last child of this node.
cloneNode	Creates a new node that is an exact clone of this node.
hasChildNodes	Returns a Boolean value of true if this node has children.
insertBefore	Inserts a child node to the left of the specified node or at the end of the list.
removeChild	Removes the specified child node from the list of children and returns it.
replaceChild	Returns the specified old child node and replaces it with the supplied new child node.

Note

   For detailed information about using the C++ programming language to access the IXMLDOMAttribute object, see the IXMLDOMAttributeIXMLDOMAttribute Interface.

Remarks

In XML, the value of an attribute is represented by the child nodes of the attribute node because the value can contain entity references. Thus attributes that contain entity references will have a child list containing both text nodes and entity reference nodes. In addition, because the attribute type might be unknown, there are no tokenized attribute values.

IXMLDOMAttribute objects inherit from the IXMLDOMNodeIXMLDOMNode Object (C#), but are not actually child nodes of the element and are not considered part of the document tree. Attributes are considered to be members of their associated elements, rather than independent and separate. Thus, the object's parentNode, previousSibling, and nextSibling properties have the value NULL.

Example

The following example creates an IXMLDOMAttribute object from the first attribute of the root element and displays the object's attribute value.

using Microsoft.WindowsMediaServices.Interop;
using interop_msxml;

// Declare variables.
WMSServer Server;
IXMLDOMDocument Playlist;
IXMLDOMElement Root;
IXMLDOMAttribute objDOMatt;


try {
    // Create a new WMSServer object.
    Server = new WMSServer();

    // Create a new playlist object.
    Playlist = Server.CreatePlaylist();

    // Load a sample playlist file.
    Playlist.load("file://c:\\wmpub\\wmroot\\simple.wsx");

    // Retrieve the root element.
    Root = Playlist.documentElement;

    // Create an IXMLDOMAttribute object and display the
    // attribute value of the first item in the first child node.
    objDOMatt = (IXMLDOMAttribute)Root.firstChild.attributes[0];
    MessageBox.Show(objDOMatt.value.ToString());
}
catch (Exception e) {
    // TODO: Handle exceptions.
}

See Also

Reference

IXMLDOMElement Object (C#)