IXMLDOMEntity (Windows CE 5.0)

Send Feedback

Represents a parsed or unparsed entity in the XML document.

Methods

The following table shows the methods for IXMLDOMEntity.

Method Description
appendChild Appends newChild as the last child of this node.
cloneNode Creates a new node that is an exact clone of this node.
hasChildNodes Returns 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 Replaces the specified old child node with the supplied new child node in the set of children of this node, and returns the old child node.
selectNodes* Applies the specified pattern-matching operation to this node's context and returns the list of matching nodes.
selectSingleNode* Applies the specified pattern-matching operation to this node's context and returns the first matching node.
transformNode* Processes this node and its children using the supplied Extensible Stylesheet Language Transformations (XSLT) style sheet and returns the resulting transformation.
transformNodeToObject* Processes this node and its children using the supplied XSLT style sheet and returns the resulting transformation in the supplied object.

* denotes an extension to the W3C DOM.

Properties

The following table shows the properties for IXMLDOMEntity.

Property Description
attributes Contains the list of attributes for this node. Read-only.
baseName* Returns the base name for the name qualified with the namespace. Read-only.
childNodes Contains a node list containing the children (for nodes that can have children). Read-only.
dataType* Specifies the data type for this node. Read/write.
definition* Returns the definition of the node in the document type definition (DTD) or schema. Read-only.
firstChild Contains the first child of this node. Read-only.
lastChild Returns the last child node. Read-only.
namespaceURI* Returns the Uniform Resource Identifier (URI) for the namespace. 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 Document Object Model (DOM) node type, which determines valid values and whether the node can have child nodes. Read-only.
nodeTypedValue* Contains this node's value, expressed in its defined data type. Read/write.
nodeTypeString* Returns the node type in string form. Read-only.
nodeValue Contains the text associated with the node. Read/write.
notationName Contains the notation name. Read-only.
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.
parsed* Contains True if this node and all descendants have been parsed and instantiated; False if any nodes remain to be parsed. Read-only.
prefix* Returns the namespace prefix. Read-only.
previousSibling Contains the left sibling of this node. Read-only.
publicId Contains the public identifier associated with the entity. Read-only.
specified* Indicates whether the node (usually an attribute) is explicitly specified or derived from a default value in the DTD or schema. Read-only.
systemId Contains the system identifier associated with the entity. Read-only.
text* Contains the text content of the node and its subtrees. Read/write.
xml* Contains the XML representation of the node and all its descendants. Read-only.

* denotes an extension to the World Wide Web Consortium (W3C) DOM.

Events

None.

Remarks

IXMLDOMEntity represents the entity itself rather than the entity declaration. The World Wide Web Consortium (W3C) Document Object Model (DOM) does not currently define an object that models the entity declaration.

According to the W3C DOM specification, an XML parser can completely expand entity references into entities before the structure model is passed to the DOM. When these entity references are expanded, the document tree does not contain any entity references.

When this parser validates the XML document, it expands external entities, except for binary entities. The nodes representing the expanded entity are available as read-only children of the entity reference. This implementation does not expand these entities when it is not validating.

The nodeName property contains the name of the entity.

The structure of the entity child list is exactly the same as the structure of the child list for the IXMLDOMEntityReference object with the same nodeName value.

Level 1 of the W3C DOM application programming interface (API) does not define a way to change entity nodes. All IXMLDOMEntity object properties are read-only. This interface inherits all of the methods, properties, and events of IXMLDOMNode.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Msxml2.h, Msxml2.idl.

See Also

DOMDocument | IXMLDOMEntityReference | nodeName Property

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.