Microsoft XML 2.5 SDK


 

IXMLDOMNode::transformNode Method

[This is preliminary documentation and subject to change.]

Processes this node and its children using the supplied XSL style sheet, and returns the resulting transformation.

Visual Basic Syntax

strValue = oXMLDOMNode.transformNode(objStylesheet)

C/C++ Syntax

HRESULT transformNode(

    IXMLDOMNode *stylesheet,

    BSTR *xmlString);

Parameters

stylesheet

[in]
Valid XML document or DOM node, which consists of XSL elements that direct the transformation of this node.

xmlString

[out]
String that contains the product of the transformation of this XML document based on the XSL style sheet.

C/C++ Return Values

S_OK

Value returned if successful.

E_INVALIDARG

Value returned if stylesheet or xmlString is null.

Remarks

The stylesheet parameter must be either a DOM Document node, in which case the document is assumed to be an XSL style sheet, or a DOM node in the XSL stylesheet, in which case this node is treated as a stand-alone style sheet fragment.

The source node defines a context for the stylesheet to operate on, but navigation outside this scope is allowed. For instance, a stylesheet could use the ancestor or id methods to access other parts of the document.

This method supports both stand-alone and embedded style sheets, and additionally provides the ability to run a localized style sheet fragment against a particular source node.

For more information about XSL, see the XSL Reference and Using the XSL Processor.