Share via


IXMLDOMEntityReference

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Represents an entity reference node.

Methods

The following table shows the methods for IXMLDOMEntityReference.

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 IXMLDOMEntityReference.

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.

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.

specified*

Indicates whether the node (usually an attribute) is explicitly specified or derived from a default value in the DTD or schema. 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

If the XML parser expands entity references while building the structure model, no EntityReference objects appear in the tree.

XML does not require non-validating processors to handle external entity declarations, such as those made in the external subset or declared in external parameter entities. This means that parsed entities declared in the external subset need not be expanded, and therefore the replacement value of the entity might not be available. If available, the replacement value of the referenced entity appears in the child list of EntityReference.

The resolution of the children of the EntityReference, the replacement value of the referenced entity, can be evaluated. Actions such as calling the childNodes property are assumed to trigger the evaluation. Character entities are expanded by the XML parser and do not appear as entity references, but instead appear within the character text in Unicode.

IXMLDOMEntityReference has no unique properties or methods of its own, but exposes the same objects and properties as the IXMLDOMNode object.

Requirements

Header msxml2.h, msxml2.idl
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

DOMDocument
IXMLDOMNode
IXMLDOMEntity

Concepts

childNodes Property