transformNode Method (Windows Embedded CE 6.0)

1/6/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

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.

See Also

Reference

XML DOM Methods