IXMLDOMDocumentFragment (Windows CE 5.0)
A lightweight object that is useful for tree insert operations.
Methods
The following table shows the methods for IXMLDOMDocumentFragment.
| 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 IXMLDOMDocumentFragment.
| 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
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.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Msxml2.h, Msxml2.idl.
See Also
DOMDocument | IXMLDOMNode | appendChild Method | insertBefore Method
Send Feedback on this topic to the authors