USXSL.Node

Retrieves a node from an XML document by an XPath expression.

Returns a node-set. If the XPath expression does not evaluate to a node, the result is empty. Otherwise, a copy of the first-matching node is returned.

A 'deep copy' of that node is returned, comparable to what <xsl:copy> returns in XSLT. This contrasts with the node's string-value, returned by USXSL.Value, and comparable to what <xsl:value-of> returns in XSLT.

Syntax

SELECT USXSL.Node(

       xml-document

,      xpath-expression

,      namespace-list

)

The required xml-document must be one of the following:

•A literal string that is an XML document.

•An alias previously connected to an in-memory XML document by calling the USXSL.SetXML method.

•A filename, or folderpath and filename.

•A URL.

If xml-document starts with "<" it is assumed to be a literal string that is an XML document. Otherwise, if it corresponds with a known alias produced by USXSL.SetXML, it is assumed to be that alias. Otherwise, it is assumed to be a reference to a file containing an XML document.

The required xpath-expression must be a valid XPath 1.0 expression.

The optional namespace-list is a list of namespace mappings for prefixes used in the XPath expression, separated by spaces.