SelectionNamespace (XmlDoc property)

Bind prefix to URI (or null) for XPath (XmlDoc class)

SelectionNamespace indicates the value of the namespace URI associated with a prefix, when the prefix is used in an XPath expression.

Syntax

%currentUnicode = doc:SelectionNamespace( prefix) doc:SelectionNamespace( prefix) = newUnicode

Syntax terms

%currentUnicode	A Unicode string %variable, set to the namespace URI associated with prefix. Prior to Sirius Mods Version 7.6, this is an EBCDIC string.
doc	An XmlDoc expression.
prefix	The prefix to be used in XPath expressions. This is a Unicode string argument; prior to Sirius Mods Version 7.6, this is an EBCDIC string.
newUnicode	The namespace absolute URI to associate with prefix, or the null string, if the prefix is not associated with the URI of a namespace. This is a Unicode string argument; prior to Sirius Mods Version 7.6, this is an EBCDIC string.

Usage notes

• When you use a name in an XPath expression to select an element or attribute in an XmlDoc, you locate only elements or attributes whose LocalName and URI values match the XPath name. You use SelectionNamespace to specify a prefix you can use for the name in your XPath expression to identify the URI of the element or attribute you are trying to locate.

  Note: Your XPath expression need not use a prefix if the element or attribute name to be matched does not have a URI. However, if an element or attribute name you want to match has a prefix, you cannot select the element or attribute by prefix and name until the prefix is defined via the SelectionNamespace method.

• An element (but not an attribute) name with no prefix may still have a URI. Such an element may have an in-scope "default namespace declaration" (see "Names and namespace syntax"). To locate this element by name with an XPath expression, you must use SelectionNamespace to associate a prefix with the URI of the element name, and use the prefix and local name of the element in the XPath expression.
• All well-formed XmlDocs implicitly include this namespace declaration in scope at the top-level document element:

  xmlns:xml="http://www.w3.org/XML/1998/namespace"

  The "xml" prefix is currently valid only for the special attributes xml:space and xml:lang. You are not allowed to:

  • Use any other "xml" prefixed element or attribute names
  • Add a namespace declaration (see AddNameSpace) for the "xml" prefix for a URI other than "http://www.w3.org/xml/1998/namespace".
  • Add a namespace declaration for "http://www.w3.org/xml/1998/namespace" that has any other prefix besides "xml"

  The URI "http://www.w3.org/xml/1998/namespace" is the value of SelectionNamespace if "xml" is the method argument.

• Prior to Sirius Mods Version 7.0, if the URI associated with a prefix is the null string, that prefix cannot be used in an XPath expression. The Sirius Mods Version 7.0 (and later) interpretation of a null-string setting (null string means "no namespace") is a Sirius extension to the XPath recommendation.
• The initial URI associated with any prefix is the null string. Therefore, prior to Sirius Mods Version 7.0, you had to set the SelectionNamespace property for any prefix to a non-null string before it could be used in an XPath expression. For Sirius Mods Version 7.0, and later, you have to set the SelectionNamespace property for any prefix that is associated with a namespace URI.

Examples

In the following example, the SelectionNamespace setting associates the prefix "SOAP" with its URI, enabling the use of that prefix later in the XPath expression in the SelectSingleNode method invocation. A subsequent invocation of SelectionNamespace returns the URI currently associated with the specified prefix.

begin %doc is object xmlDoc %doc = new %doc:loadXml('<top - xmlns:SOAP="http://SCHEMAS.XMLSOAP.ORG/soap/"> - <a><SOAP:b></SOAP:b></a></top>') %doc:selectionNamespace('SOAP')= - 'http://SCHEMAS.XMLSOAP.ORG/soap/' %n1 is object xmlNode %n1 = %doc:electSingleNode('top/a/SOAP:b') Call %n1:addElement('c') call %doc:print print 'The URI of node SOAP:b is: ' %n1:URI print 'The URI for SOAP as an XPath prefix is:' and - %doc:SelectionNamespace('SOAP') end

The example result follows:

<top xmlns:SOAP="http://SCHEMAS.XMLSOAP.ORG/soap/"> <a> <SOAP:b> <c/> </SOAP:b> </a> </top> The URI of node SOAP:b is: http://SCHEMAS.XMLSOAP.ORG/soap/ The URI for SOAP as an XPath prefix is: http://SCHEMAS.XMLSOAP.ORG/soap/

Request-cancellation errors

This list is not exhaustive: it does not include all the errors that are request cancelling.

• Argument prefix is not a valid name prefix.
• Argument newUniCode is not a valid absolute Uniform Resource Identifier.

See also

• For more information about namespaces, see "Names and namespaces", including its subsections.
• These methods are also useful for working with namespaces:
  • AddNamespace
  • AddElement
• These methods are useful for working with prefixes:
  • IsSelectionPrefix
  • DeleteSelectionPrefix

XmlDoc class XmlNode class XmlNodelist class	List of XmlDoc methods List of XmlNode methods List of XmlNodelist methods List of XmlDoc API methods	XmlDoc methods syntax XmlNode methods syntax XmlNodelist methods syntax
Notation conventions for methods