IXMLDOMNode::transformNode Method

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

Syntax

HRESULT transformNode(
    IXMLDOMNode * stylesheet,
    BSTR * xmlString);

Parameters

stylesheet

[in] Valid XML document or document fragment 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 stylesheet.

Return Value

Returns S_OK if successful, or an error code otherwise.

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 namespace, in which case this node is treated as a standalone style sheet fragment.

The source node defines the entire context for the style sheet to operate on, so ancestor or ID navigation outside this scope is not allowed. The scope of a style sheet fragment is limited to those rules within it. Calling outside this fragment is not supported.

This method supports both standalone 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.