IXMLDOMDocumentFragment
A version of this page is also available for
4/8/2010
A lightweight object that is useful for tree insert operations.
Methods
The following table shows the methods for IXMLDOMDocumentFragment.
| Method | Description |
|---|---|
Appends newChild as the last child of this node. |
|
Creates a new node that is an exact clone of this node. |
|
Returns True if this node has children. |
|
Inserts a child node to the left of the specified node or at the end of the list. |
|
Removes the specified child node from the list of children and returns it. |
|
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. |
|
Applies the specified pattern-matching operation to this node's context and returns the list of matching nodes. |
|
Applies the specified pattern-matching operation to this node's context and returns the first matching node. |
|
Processes this node and its children using the supplied Extensible Stylesheet Language Transformations (XSLT) style sheet and returns the resulting transformation. |
|
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 |
|---|---|
Contains the list of attributes for this node. Read-only. |
|
Returns the base name for the name qualified with the namespace. Read-only. |
|
Contains a node list containing the children (for nodes that can have children). Read-only. |
|
Specifies the data type for this node. Read/write. |
|
Returns the definition of the node in the document type definition (DTD) or schema. Read-only. |
|
Contains the first child of this node. Read-only. |
|
Returns the last child node. Read-only. |
|
Returns the Uniform Resource Identifier (URI) for the namespace. Read-only. |
|
Contains the next sibling of this node in the parent's child list. Read-only. |
|
Contains the qualified name of the element, attribute, or entity reference, or a fixed string for other node types. Read-only. |
|
Specifies the XML Document Object Model (DOM) node type, which determines valid values and whether the node can have child nodes. Read-only. |
|
Contains this node's value, expressed in its defined data type. Read/write. |
|
Returns the node type in string form. Read-only. |
|
Contains the text associated with the node. Read/write. |
|
Returns the root of the document that contains this node. Read-only. |
|
Contains the parent node (for nodes that can have parents). Read-only. |
|
Contains True if this node and all descendants have been parsed and instantiated; False if any nodes remain to be parsed. Read-only. |
|
Returns the namespace prefix. Read-only. |
|
Contains the left sibling of this node. Read-only. |
|
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
| Header | msxml2.h, msxml2.idl |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |