Namespace (XmlDoc property)
(Dis)allow or disable prefix handling (XmlDoc class)
Namespace determines namespace handling in the XmlDoc, with the mapping of QName (qualified name) prefixes to namespace URIs.
%currentXmlNamespaceSetting = doc:Namespace doc:Namespace = newXmlNamespaceSetting
|%currentXmlNamespaceSetting||The XmlNamespaceSetting enumeration value of doc's Namespace property. Valid values are On, Ignore, and None, as described below.|
|doc||An XmlDoc object expression.|
|newXmlNamespaceSetting||The XmlNamespaceSetting enumeration value to assign to doc's Namespace property.|
The values of the Namespace property are of type Enumeration XmlNamespaceSetting; these values and their meanings are shown below:
|On||This is the initial value of the Namespace property. With this setting, the requirements imposed by the XML Namespaces Recommendation are followed by Janus SOAP. That is, wherever a prefix occurs in the name of an element or attribute in the document, a namespace declaration must be in effect for that prefix.|
|Ignore||With this setting, namespaces are not handled in any way by Janus SOAP; specifically:|
|None||With this setting, namespaces are not allowed in a document; specifically:
Note: As with all enumerations, the ToString method implicitly converts an enumeration value to a character string whose value is the name of the enumeration value. For more information about methods available to all enumerations, see Common enumeration methods.
- The Namespace property may not be changed if an XmlDoc contains an Element node.
- Every name in the document is treated as a character string, which may include a colon.
- A namespace declaration during deserialization is simply treated as an attribute, whose name begins with the characters "xmlns".
- The request is cancelled if the URI argument is passed by an Element- or Attribute-adding method like AddElement, AddAttribute, InsertElementBefore, and so on.
The following example obtains the string value of the Namespace property:
%str = doc:namespace:toString
Request-cancellation errors (for set method)s
This list is not exhaustive: it does not include all the errors that are request cancelling.
- XmlDoc contains an Element node.