transformNode 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
strValue = oXMLDOMNode.transformNode(objStylesheet);
Remarks
Script Parameters
- objstylesheet
Object. Valid XML document or DOM node that consists of XSLT elements that direct the transformation of this node.
Script Return Value
String. Returns a string that contains the product of the transformation of this XML document based on the XSLT style sheet.
C/C++ Syntax
HRESULT transformNode(
IXMLDOMNode* stylesheet,
BSTR* xmlString
);
Remarks
C/C++ Parameters
- stylesheet
[in] Valid XML document or DOM node that consists of XSLT elements that direct the transformation of this node.
- xmlString
[out, retval] String that contains the product of the transformation of this XML document based on the XSLT style sheet.
C/C++ Return Values
- S_OK
Value returned if successful.
- E_INVALIDARG
Value returned if stylesheet or xmlString 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 Extensible Stylesheet Language (XSL) style sheet, or a Document Object Model (DOM) node in the XSL 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.
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, and IXTLRuntime.