IXMLDOMDocumentFragment (Windows CE 5.0)
A lightweight object that is useful for tree insert operations.
The following table shows the methods for IXMLDOMDocumentFragment.
|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.
The following table shows the properties for IXMLDOMDocumentFragment.
|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.
The DocumentFragment object can represent a fragment of a document or portion of a document's tree. This makes the DocumentFragment useful when implementing end user commands that allow users to rearrange a document, such as cutting and pasting.
The DocumentFragment node has special, defined behavior for IXMLDOMNode insert operations that makes it especially convenient for developers. When an IXMLDOMDocumentFragment is inserted into a DOMDocument node, or other node that can take children; the children of the DocumentFragment are inserted into the node rather than the DocumentFragment itself. This makes the DocumentFragment useful when the user wants to create nodes that are siblings; the DocumentFragment acts as the parent of these nodes so that the user can employ the standard methods from the IXMLDOMNode interface, such as insertBefore and appendChild.
The children of a DocumentFragment node make up zero or more nodes representing the tops of any subtrees defining the structure of the document. DocumentFragment nodes do not need to be well-formed XML documents (although they do need to follow the rules imposed upon well-formed XML parsed entities, which can have multiple top nodes). For example, a DocumentFragment might have only one child, and that child node could be a Text node. Such a structure model represents neither an HTML document nor a well-formed XML document.
IXMLDOMDocumentFragment has no unique members of its own, but inherits all the members of IXMLDOMNode.
OS Versions: Windows CE .NET 4.0 and later.
Header: Msxml2.h, Msxml2.idl.
Send Feedback on this topic to the authors