transformNode Method

A version of this page is also available for

Windows Embedded CE 6.0 R3

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.