transformNodeToObject Method
A version of this page is also available for
4/8/2010
Processes this node and its children using the supplied Extensible Stylesheet Language Transformations (XSLT) style sheet and returns the resulting transformation.
Script Syntax
oXMLDOMNode.transformNodeToObject(stylesheet, outputObject);
Remarks
Script Parameters
- stylesheet
Object. Valid XML document or DOM node that consists of XSLT elements that direct the transformation of this node.
- outputObject
Object. On return, contains the product of the transformation of this XML document based on the XSLT style sheet. If the variant represents the DOMDocument object, the document is built according to its properties and its child nodes are replaced during this transformation process. The XML transformation can also be sent to a stream.
C/C++ Syntax
HRESULT transformNodeToObject(
IXMLDOMNode* stylesheet,
VARIANT outputObject
);
Remarks
C/C++ Parameters
- stylesheet
[in] Valid XML document or DOM node that consists of XSL elements that direct the transformation of this node.
- outputObject
[in] Object that contains the product of the transformation of this XML document based on the XSLT style sheet. If the variant represents DOMDocument, the document is built according to its properties and its child nodes are replaced during this transformation process. If the variant contains an IStream interface, the XML transformation is sent to this stream.
C/C++ Return Values
- S_OK
Value returned if successful.
- E_INVALIDARG
Value returned if stylesheet or outputObject is Null.
Requirements
| Header | msxml2.h, msxml2.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
General Remarks
This method is only valid if the XSLT feature has been included in the operating system (OS). If a call to this method is made and XSLT is not supported, an error message will be returned.
The stylesheet parameter must be either a DOMDocument node, in which case the document is assumed to be an XSLT style sheet, or a Document Object Model (DOM) node in the XSLT style sheet, in which case this node is treated as a stand-alone style sheet fragment.
The source node defines a context in which the style sheet operates, but navigation outside this scope is allowed. For example, a style sheet can use the id function to access other parts of the document.
This method supports both stand-alone and embedded style sheets and also provides the ability to run a localized style sheet fragment against a particular source node.
The transformNodeToObject method always generates a Unicode byte-order mark, which means it cannot be used in conjunction with other Active Server Pages (ASP) Response.Write or Response.BinaryWrite calls.
This member is an extension of the World Wide Web Consortium (W3C) DOM.
This method applies to the following objects and interfaces:
IXMLDOMAttribute, IXMLDOMCDATASection, IXMLDOMCharacterData, IXMLDOMComment, DOMDocument, IXMLDOMDocumentFragment, IXMLDOMDocumentType, IXMLDOMElement, IXMLDOMEntity, IXMLDOMEntityReference, IXMLDOMNode, IXMLDOMNotation, IXMLDOMProcessingInstruction, IXMLDOMText, IXTLRuntime.