Namespace (XmlDoc property) - Revision history

JAL: /* XmlNamespaceSetting enumeration */

2014-07-23T19:47:28Z

XmlNamespaceSetting enumeration

← Older revision		Revision as of 19:47, 23 July 2014
Line 15:		Line 15:
	===XmlNamespaceSetting enumeration===		===XmlNamespaceSetting enumeration===
	The values of the <var>Namespace</var> property are of type <var>[[Enumerations\|Enumeration]]</var> <var>XmlNamespaceSetting</var>; these values and their meanings are shown below:		The values of the <var>Namespace</var> property are of type <var>[[Enumerations\|Enumeration]]</var> <var>XmlNamespaceSetting</var>; these values and their meanings are shown below:
	<table>		<table class="thJustBold">
	<tr><th>On</th>		<tr><th>On</th>
	<td>This is the initial value of the <var>Namespace</var> property. With this setting, the requirements imposed by the [http://www.w3.org/TR/REC-xml-names/ XML Namespaces Recommendation] are followed by <var class="product">[[Janus SOAP]]</var>. 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.</td></tr>		<td>This is the initial value of the <var>Namespace</var> property. With this setting, the requirements imposed by the [http://www.w3.org/TR/REC-xml-names/ XML Namespaces Recommendation] are followed by <var class="product">[[Janus SOAP]]</var>. 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.</td></tr>
Line 47:		Line 47:
	</ul></td></tr></table>		</ul></td></tr></table>

	<p class="note">'''Note:''' As with all enumerations, the <var>ToString</var> 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 [[Enumerations#Common enumeration methods\|"Common enumeration methods"]]. </p>		<p class="note">'''Note:''' As with all enumerations, the <var>ToString</var> 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 [[Enumerations#Common enumeration methods\|Common enumeration methods]]. </p>

	==Usage notes==		==Usage notes==

JAL at 20:49, 3 March 2014

2014-03-03T20:49:18Z

← Older revision		Revision as of 20:49, 3 March 2014
Line 47:		Line 47:
	</ul></td></tr></table>		</ul></td></tr></table>

	'''Note:''' As with all enumerations, the <var>ToString</var> 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 [[Enumerations#Common enumeration methods\|"Common enumeration methods"]].		<p class="note">'''Note:''' As with all enumerations, the <var>ToString</var> 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 [[Enumerations#Common enumeration methods\|"Common enumeration methods"]]. </p>

	==Usage notes==		==Usage notes==
Line 63:		Line 63:

	==Request-cancellation errors (for set method)s==		==Request-cancellation errors (for set method)s==
			This list is not exhaustive: it does <i>not</i> include all the errors that are request cancelling.
	<ul>		<ul>
	<li><var>XmlDoc</var> contains an <var>Element</var> node.		<li><var>XmlDoc</var> contains an <var>Element</var> node.

JAL: /* XmlNamespaceSetting enumeration */

2012-11-28T20:08:28Z

XmlNamespaceSetting enumeration

New page

{{Template:XmlDoc:Namespace subtitle}}
<var>Namespace</var> determines namespace handling in the <var>XmlDoc</var>, with the mapping of QName (qualified name) prefixes to namespace URIs.

==Syntax==
{{Template:XmlDoc:Namespace syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%currentXmlNamespaceSetting</th>
<td>The <var>XmlNamespaceSetting</var> enumeration value of <var class="term">doc</var>'s <var>Namespace</var> property. Valid values are <var>On</var>, <var>Ignore</var>, and <var>None</var>, as described below.</td></tr>
<tr><th>doc</th>
<td>An <var>XmlDoc</var> object expression.</td></tr>
<tr><th>newXmlNamespaceSetting</th>
<td>The <var>XmlNamespaceSetting</var> enumeration value to assign to <var class="term">doc</var>'s <var>Namespace</var> property.</td></tr>
</table>
===XmlNamespaceSetting enumeration===
The values of the <var>Namespace</var> property are of type <var>[[Enumerations|Enumeration]]</var> <var>XmlNamespaceSetting</var>; these values and their meanings are shown below:
<table>
<tr><th>On</th>
<td>This is the initial value of the <var>Namespace</var> property. With this setting, the requirements imposed by the [http://www.w3.org/TR/REC-xml-names/ XML Namespaces Recommendation] are followed by <var class="product">[[Janus SOAP]]</var>. 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.</td></tr>

<tr><th>Ignore</th>
<td>With this setting, namespaces are not handled in any way by <var class="product">Janus SOAP</var>; specifically:
<ul>
<li>Invoking the <var>[[SelectionNamespace_(XmlDoc_property)|SelectionNamespace]]</var> property causes a request cancellation.

<li>Invoking the <var>[[LocalName (XmlDoc/XmlNode function)|LocalName]]</var>, <var>[[Prefix (XmlDoc/XmlNode function)|Prefix]]</var>, or <var>[[URI (XmlDoc/XmlNode function)|URI]]</var> functions
causes a request cancellation.

<li>Invoking the <var>[[AddNamespace_(XmlNode_subroutine)|AddNamespace]]</var> subroutine causes a request cancellation.
</ul></td></tr>

<tr><th>None</th>
<td>With this setting, namespaces are not allowed in a document; specifically:
<ul>
<li>Any name including a colon causes a request cancellation.

<li>Any namespace declaration during deserialization causes a request cancellation (prior to <var class="product">[[Sirius Mods]]</var> Version 7.7, default namespace declarations were deserialized as if they were attributes).

<li>The request is cancelled if the <var>URI</var> argument is passed by an Element- or Attribute-adding method like <var>[[AddElement (XmlDoc/XmlNode function)|AddElement]]</var>, <var>[[AddAttribute (XmlNode function)|AddAttribute]]</var>, <var>[[InsertElementBefore (XmlNode function)|InsertElementBefore]]</var>, and so on.

<li>Invoking the <var>SelectionNamespace</var> property causes a request cancellation.

<li>Invoking the <var>LocalName</var>, <var>Prefix</var>, or <var>URI</var> functions
causes a request cancellation.

<li>Invoking the <var>AddNamespace</var> subroutine causes a request cancellation.
</ul></td></tr></table>

'''Note:''' As with all enumerations, the <var>ToString</var> 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 [[Enumerations#Common enumeration methods|"Common enumeration methods"]].

==Usage notes==
<ul>
<li>The <var>Namespace</var> property may not be changed if an <var>XmlDoc</var> contains an <var>Element</var> node.
<li>Every name in the document is treated as a character string, which may include a colon.
<li>A namespace declaration during deserialization is simply treated as an attribute, whose name begins with the characters "xmlns".
<li>The request is cancelled if the URI argument is passed by an Element- or Attribute-adding method like <var>[[AddElement (XmlDoc/XmlNode function)|AddElement]]</var>, <var>[[AddAttribute (XmlNode function)|AddAttribute]]</var>, <var>[[InsertElementBefore (XmlNode function)|InsertElementBefore]]</var>, and so on.
</ul>

==Examples==
The following example obtains the string value of the <var>Namespace</var> property:
<p class="code">%str = doc:namespace:toString
</p>

==Request-cancellation errors (for set method)s==
<ul>
<li><var>XmlDoc</var> contains an <var>Element</var> node.
</ul>

==See also==
{{Template:XmlDoc:Namespace footer}}

JAL2 at 21:47, 7 August 2012

2012-08-07T21:47:44Z

← Older revision		Revision as of 21:47, 7 August 2012
Line 31:		Line 31:
	<li>Any name including a colon causes a request cancellation.		<li>Any name including a colon causes a request cancellation.
	<li>Any namespace declaration during deserialization causes a request cancellation (prior to <var class="product">[[Sirius Mods]]</var> Version 7.7, default namespace declarations were deserialized as if they were attributes).		<li>Any namespace declaration during deserialization causes a request cancellation (prior to <var class="product">[[Sirius Mods]]</var> Version 7.7, default namespace declarations were deserialized as if they were attributes).
	<li>The request is cancelled if the <var ~~class="term"~~>URI</var> argument is passed by an Element- or Attribute-adding method like <var>[[AddElement (XmlDoc/XmlNode function)\|AddElement]]</var>, <var>[[AddAttribute (XmlNode function)\|AddAttribute]]</var>, <var>[[InsertElementBefore (XmlNode function)\|InsertElementBefore]]</var>, and so on.		<li>The request is cancelled if the <var>URI</var> argument is passed by an Element- or Attribute-adding method like <var>[[AddElement (XmlDoc/XmlNode function)\|AddElement]]</var>, <var>[[AddAttribute (XmlNode function)\|AddAttribute]]</var>, <var>[[InsertElementBefore (XmlNode function)\|InsertElementBefore]]</var>, and so on.
	<li>Invoking the <var>SelectionNamespace</var> property causes a request cancellation.		<li>Invoking the <var>SelectionNamespace</var> property causes a request cancellation.
	<li>Invoking the <var>[[LocalName (XmlDoc/XmlNode function)\|LocalName]]</var>, <var>[[Prefix (XmlDoc/XmlNode function)\|Prefix]]</var>, or <var>[[URI (XmlDoc/XmlNode function)\|URI]]</var> functions		<li>Invoking the <var>[[LocalName (XmlDoc/XmlNode function)\|LocalName]]</var>, <var>[[Prefix (XmlDoc/XmlNode function)\|Prefix]]</var>, or <var>[[URI (XmlDoc/XmlNode function)\|URI]]</var> functions

JAL2: /* Syntax terms */

2011-08-16T21:26:34Z

Syntax terms

← Older revision		Revision as of 21:26, 16 August 2011
Line 37:		Line 37:
	<li>Invoking the <var>[[AddNamespace_(XmlNode_subroutine)\|AddNamespace]]</var> subroutine causes a request cancellation.		<li>Invoking the <var>[[AddNamespace_(XmlNode_subroutine)\|AddNamespace]]</var> subroutine causes a request cancellation.
	</ul></td></tr></table>		</ul></td></tr></table>

			'''Note:''' As with all enumerations, the <var>ToString</var> 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 [[Enumerations#Common enumeration methods\|"Common enumeration methods"]].

	==Usage notes==		==Usage notes==
	<ul>		<ul>

JALWiccan: 1 revision

2011-06-06T19:05:47Z

1 revision

← Older revision	Revision as of 19:05, 6 June 2011
(No difference)

JALWiccan: 1 revision

2011-06-06T19:05:46Z

1 revision

← Older revision		Revision as of 19:05, 6 June 2011
Line 50:		Line 50:
	</p>		</p>

	==Request-~~Cancellation Errors/~~ (for set method)s==		==Request-cancellation errors (for set method)s==
	<ul>		<ul>
	<li><var>XmlDoc</var> contains an <var>Element</var> node.		<li><var>XmlDoc</var> contains an <var>Element</var> node.

JALWiccan: 1 revision

2011-06-06T17:44:02Z

1 revision

← Older revision	Revision as of 17:44, 6 June 2011
(No difference)

JAL2 at 17:44, 6 June 2011

2011-06-06T17:44:01Z

← Older revision		Revision as of 17:44, 6 June 2011
Line 50:		Line 50:
	</p>		</p>

	==Request-Cancellation Errors (for set method)s==		==Request-Cancellation Errors/ (for set method)s==
	<ul>		<ul>
	<li><var>XmlDoc</var> contains an <var>Element</var> node.		<li><var>XmlDoc</var> contains an <var>Element</var> node.

JAL2 at 21:35, 1 June 2011

2011-06-01T21:35:10Z

← Older revision		Revision as of 21:35, 1 June 2011
Line 7:		Line 7:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%currentXmlNamespaceSetting</th>		<tr><th>%currentXmlNamespaceSetting</th>
	<td>The <var>XmlNamespaceSetting</var> enumeration value of <var class="term">doc</var>'s <var>Namespace</var> property. Valid values are <~~code~~>On</~~code~~>, <~~code~~>Ignore</~~code~~>, and <~~code~~>None</~~code~~>, as described ~~in [[#Usage_Notes\|"Usage Notes"]],~~ below.</td></tr>		<td>The <var>XmlNamespaceSetting</var> enumeration value of <var class="term">doc</var>'s <var>Namespace</var> property. Valid values are <var>On</var>, <var>Ignore</var>, and <var>None</var>, as described below.</td></tr>
	<tr><th>doc</th>		<tr><th>doc</th>
	<td>An <var>XmlDoc</var> object expression.</td></tr>		<td>An <var>XmlDoc</var> object expression.</td></tr>