transformNode Method (Compact 2013)

3/26/2014

Processes this node and its children using the supplied Extensible Stylesheet Language Transformations (XSLT) style sheet and returns the resulting transformation.

Syntax

strValue = oXMLDOMNode.transformNode(objStylesheet);

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

Parameters

Script

• objstylesheet
  Object. Valid XML document or DOM node that consists of XSLT elements that direct the transformation of this node.

C/C++

• 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.

Return Value

Script

String. Returns a string that contains the product of the transformation of this XML document based on the XSLT style sheet.

C/C++

• S_OK
  Value returned if successful.

• E_INVALIDARG
  Value returned if stylesheet or xmlString is Null.

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.

Requirements

See Also

Reference

XML DOM Methods