Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
A lightweight object that is useful for tree insert operations.
Methods
The following table shows the methods for IXMLDOMDocumentFragment.
Method | Description |
---|---|
Appends newChildas 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 DocumentFragmentobject can represent a fragment of a document or portion of a document's tree. This makes the DocumentFragmentuseful when implementing end user commands that allow users to rearrange a document, such as cutting and pasting.
The DocumentFragmentnode has special, defined behavior for IXMLDOMNodeinsert operations that makes it especially convenient for developers. When an IXMLDOMDocumentFragmentis inserted into a DOMDocumentnode, or other node that can take children; the children of the DocumentFragmentare inserted into the node rather than the DocumentFragmentitself. This makes the DocumentFragmentuseful when the user wants to create nodes that are siblings; the DocumentFragmentacts as the parent of these nodes so that the user can employ the standard methods from the IXMLDOMNodeinterface, such as insertBeforeand appendChild.
The children of a DocumentFragmentnode make up zero or more nodes representing the tops of any subtrees defining the structure of the document. DocumentFragmentnodes 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 DocumentFragmentmight have only one child, and that child node could be a Textnode. Such a structure model represents neither an HTML document nor a well-formed XML document.
IXMLDOMDocumentFragmenthas 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 |