AllowNull (XmlDoc property) - Revision history

JAL2 at 20:49, 31 May 2011

2011-05-31T20:49:06Z

← Older revision		Revision as of 20:49, 31 May 2011
Line 7:		Line 7:
	<p class="code">%nod:AddElement('a', 'Element contains null:' With $X2C('00'))		<p class="code">%nod:AddElement('a', 'Element contains null:' With $X2C('00'))
	</p>		</p>
	~~<p>The default value of <var>AllowNull</var> is <var>False</var>.</p>~~

	==Syntax==		==Syntax==
Line 27:		Line 26:
	now obsolete <code>InvalidChar=Allow</code> setting to allow null characters in an <var>XmlDoc</var>, you can use <code>AllowNull=True</code> instead.		now obsolete <code>InvalidChar=Allow</code> setting to allow null characters in an <var>XmlDoc</var>, you can use <code>AllowNull=True</code> instead.
	<li>Deserialization of Unicode characters that do not translate to EBCDIC is not allowed unless the <var>[[LoadXml (XmlDoc/XmlNode function)#allowUntrans\|AllowUntranslatable]]</var> deserialization option is used.		<li>Deserialization of Unicode characters that do not translate to EBCDIC is not allowed unless the <var>[[LoadXml (XmlDoc/XmlNode function)#allowUntrans\|AllowUntranslatable]]</var> deserialization option is used.
	<li>When providing EBCDIC characters to be stored in an <var>XmlDoc</var>, those EBCDIC characters must be translatable to Unicode. If you have EBCDIC strings that may not be translatable, you must handle those before passing them to an <var>XmlDoc</var> update operation. For example, you may be able to use the <var ~~class="term"~~>Untranslatable</var> argument of the <var>[[EbcdicToUnicode (String function)\|EbcdicToUnicode]]</var> function.		<li>When providing EBCDIC characters to be stored in an <var>XmlDoc</var>, those EBCDIC characters must be translatable to Unicode. If you have EBCDIC strings that may not be translatable, you must handle those before passing them to an <var>XmlDoc</var> update operation. For example, you may be able to use the <var>Untranslatable</var> argument of the <var>[[EbcdicToUnicode (String function)\|EbcdicToUnicode]]</var> function.
	<li>A null character in an <var>XmlDoc</var> is serialized as an XML hexadecimal character reference: <code>&#x0;</code>.		<li>A null character in an <var>XmlDoc</var> is serialized as an XML hexadecimal character reference: <code>&#x0;</code>.
	<li><var>AllowNull</var> is new as of <var class="product">[[Sirius Mods]]</var> Version 7.6.		<li><var>AllowNull</var> is new as of <var class="product">[[Sirius Mods]]</var> Version 7.6.
Line 33:		Line 32:

	==Examples==		==Examples==
	In the following request, an ~~Ebcdic~~ X'FF' character requires a replacement to avoid request cancellation, but setting <var>AllowNull</var> to <code>True</code> lets a null be added to the <var>XmlDoc</var>.		In the following request, an EBCDIC X'FF' character requires a replacement to avoid request cancellation, but setting <var>AllowNull</var> to <code>True</code> lets a null be added to the <var>XmlDoc</var>.
	<p class="code">Begin		<p class="code">Begin
	%d is object xmldoc auto new		%d is object xmldoc auto new

JAL2 at 22:44, 24 May 2011

2011-05-24T22:44:14Z

← Older revision		Revision as of 22:44, 24 May 2011
Line 1:		Line 1:
	~~{{DISPLAYTITLE:<tt>allowNull</tt> (<tt>XmlDoc</tt> property)}}~~
	{{Template:XmlDoc:AllowNull subtitle}}		{{Template:XmlDoc:AllowNull subtitle}}
	The <var>~~allowNull~~</var> property indicates whether or not the method object <var>XmlDoc</var> allows the deserialization of an XML document that contains nodes that have null characters (U+0000) in their values. A <var>[[Enumerations#Using Boolean enumerations\|Boolean]]</var> value of <~~code~~>True</~~code~~> allows such deserializations. The default value, <~~code~~>False</~~code~~>, cancels the request if such a deserialization is attempted.		The <var>AllowNull</var> property indicates whether or not the method object <var>XmlDoc</var> allows the deserialization of an XML document that contains nodes that have null characters (U+0000) in their values. A <var>[[Enumerations#Using Boolean enumerations\|Boolean]]</var> value of <var>True</var> allows such deserializations. The default value, <var>False</var>, cancels the request if such a deserialization is attempted.
	<p>For example, the following <var>Element</var> node is acceptable for deserialization into an <var>XmlDoc</var> (for example, by using <var>[[LoadXml (XmlDoc/XmlNode function)\|LoadXml]]</var>) only if <var>AllowNull</var> is <~~code~~>True</~~code~~>:</p>		<p>For example, the following <var>Element</var> node is acceptable for deserialization into an <var>XmlDoc</var> (for example, by using <var>[[LoadXml (XmlDoc/XmlNode function)\|LoadXml]]</var>) only if <var>AllowNull</var> is <var>True</var>:</p>
	<p class="code"><a>Element contains null: &~~amp;amp;~~amp;#0;</a>		<p class="code"><a>Element contains null: &#0;</a>
	</p>		</p>
	<p>If <code>AllowNull=True</code>, null characters are also allowed for "direct setting" of a node's value using one of the many <var>Add</var> or </var>Insert</var> methods. For example:</p>		<p>If <code>AllowNull=True</code>, null characters are also allowed for "direct setting" of a node's value using one of the many <var>Add</var> or <var>Insert</var> methods. For example:</p>
	<p class="code">%nod:AddElement('a', 'Element contains null:' With $X2C('00'))		<p class="code">%nod:AddElement('a', 'Element contains null:' With $X2C('00'))
	</p>		</p>
	<p>The default value of <var>AllowNull</var> is <~~code~~>False</~~code~~>.</p>		<p>The default value of <var>AllowNull</var> is <var>False</var>.</p>

	==Syntax==		==Syntax==
Line 15:		Line 14:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%currentBoolean</th>		<tr><th>%currentBoolean</th>
	<td>The <var>Boolean</var> enumeration value of <var class="term">doc</var>'s <var>AllowNull</var> property~~. For more information about these enumerations, see [[Enumerations#Using_Boolean_enumerations\|"Using Boolean enumerations"]]~~. </td></tr>		<td>The <var>Boolean</var> enumeration value of <var class="term">doc</var>'s <var>AllowNull</var> property. </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>
Line 29:		Line 28:
	<li>Deserialization of Unicode characters that do not translate to EBCDIC is not allowed unless the <var>[[LoadXml (XmlDoc/XmlNode function)#allowUntrans\|AllowUntranslatable]]</var> deserialization option is used.		<li>Deserialization of Unicode characters that do not translate to EBCDIC is not allowed unless the <var>[[LoadXml (XmlDoc/XmlNode function)#allowUntrans\|AllowUntranslatable]]</var> deserialization option is used.
	<li>When providing EBCDIC characters to be stored in an <var>XmlDoc</var>, those EBCDIC characters must be translatable to Unicode. If you have EBCDIC strings that may not be translatable, you must handle those before passing them to an <var>XmlDoc</var> update operation. For example, you may be able to use the <var class="term">Untranslatable</var> argument of the <var>[[EbcdicToUnicode (String function)\|EbcdicToUnicode]]</var> function.		<li>When providing EBCDIC characters to be stored in an <var>XmlDoc</var>, those EBCDIC characters must be translatable to Unicode. If you have EBCDIC strings that may not be translatable, you must handle those before passing them to an <var>XmlDoc</var> update operation. For example, you may be able to use the <var class="term">Untranslatable</var> argument of the <var>[[EbcdicToUnicode (String function)\|EbcdicToUnicode]]</var> function.
	<li>A null character in an <var>XmlDoc</var> is serialized as an XML hexadecimal character reference: <code>&~~amp;amp;~~amp;#x0;</code>.		<li>A null character in an <var>XmlDoc</var> is serialized as an XML hexadecimal character reference: <code>&#x0;</code>.
	<li><var>AllowNull</var> is new as of <var class="product">[[Sirius Mods]]</var> Version 7.6.		<li><var>AllowNull</var> is new as of <var class="product">[[Sirius Mods]]</var> Version 7.6.
	</ul>		</ul>

	==Examples==		==Examples==
	~~<ol><li>~~
	In the following request, an Ebcdic X'FF' character requires a replacement to avoid request cancellation, but setting <var>AllowNull</var> to <code>True</code> lets a null be added to the <var>XmlDoc</var>.		In the following request, an Ebcdic X'FF' character requires a replacement to avoid request cancellation, but setting <var>AllowNull</var> to <code>True</code> lets a null be added to the <var>XmlDoc</var>.
	<p class="code">Begin		<p class="code">Begin
Line 62:		Line 60:
	The Buddha dog says		The Buddha dog says
	<nowiki><!--substitute character is ?--></nowiki>		<nowiki><!--substitute character is ?--></nowiki>
	<a>nothingness: &~~amp;amp;~~amp;#x0;</a>		<a>nothingness: &#x0;</a>
	</zen>		</zen>
	</p>		</p>

JALWiccan: 1 revision

2011-05-24T20:31:55Z

1 revision

← Older revision	Revision as of 20:31, 24 May 2011
(No difference)

JALWiccan: 1 revision

2011-05-24T20:31:54Z

1 revision

← Older revision		Revision as of 20:31, 24 May 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:<tt>allowNull</tt> (<tt>XmlDoc</tt> property)}}		{{DISPLAYTITLE:<tt>allowNull</tt> (<tt>XmlDoc</tt> property)}}
	{{Template:XmlDoc:AllowNull subtitle}}		{{Template:XmlDoc:AllowNull subtitle}}
	The <var>allowNull</var> property indicates whether or not the method object <var>XmlDoc</var> allows the deserialization of an XML document that contains nodes that have null characters (U+0000) in their values. A <var>[[Boolean]]</var> value of <code>True</code> allows such deserializations. The default value, <code>False</code>, cancels the request if such a deserialization is attempted.		The <var>allowNull</var> property indicates whether or not the method object <var>XmlDoc</var> allows the deserialization of an XML document that contains nodes that have null characters (U+0000) in their values. A <var>[[Enumerations#Using Boolean enumerations\|Boolean]]</var> value of <code>True</code> allows such deserializations. The default value, <code>False</code>, cancels the request if such a deserialization is attempted.
	<p>For example, the following <var>Element</var> node is acceptable for deserialization into an <var>XmlDoc</var> (for example, by using <var>[[LoadXml (XmlDoc/XmlNode function)\|LoadXml]]</var>) only if <var>AllowNull</var> is <code>True</code>:</p>		<p>For example, the following <var>Element</var> node is acceptable for deserialization into an <var>XmlDoc</var> (for example, by using <var>[[LoadXml (XmlDoc/XmlNode function)\|LoadXml]]</var>) only if <var>AllowNull</var> is <code>True</code>:</p>
	<p class="code"><a>Element contains null: &amp;#0;</a>		<p class="code"><a>Element contains null: &amp;amp;#0;</a>
	</p>		</p>
	<p>If <code>AllowNull=True</code>, null characters are also allowed for "direct setting" of a node's value using one of the many <var>Add</var> or </var>Insert</var> methods. For example:</p>		<p>If <code>AllowNull=True</code>, null characters are also allowed for "direct setting" of a node's value using one of the many <var>Add</var> or </var>Insert</var> methods. For example:</p>
Line 29:		Line 29:
	<li>Deserialization of Unicode characters that do not translate to EBCDIC is not allowed unless the <var>[[LoadXml (XmlDoc/XmlNode function)#allowUntrans\|AllowUntranslatable]]</var> deserialization option is used.		<li>Deserialization of Unicode characters that do not translate to EBCDIC is not allowed unless the <var>[[LoadXml (XmlDoc/XmlNode function)#allowUntrans\|AllowUntranslatable]]</var> deserialization option is used.
	<li>When providing EBCDIC characters to be stored in an <var>XmlDoc</var>, those EBCDIC characters must be translatable to Unicode. If you have EBCDIC strings that may not be translatable, you must handle those before passing them to an <var>XmlDoc</var> update operation. For example, you may be able to use the <var class="term">Untranslatable</var> argument of the <var>[[EbcdicToUnicode (String function)\|EbcdicToUnicode]]</var> function.		<li>When providing EBCDIC characters to be stored in an <var>XmlDoc</var>, those EBCDIC characters must be translatable to Unicode. If you have EBCDIC strings that may not be translatable, you must handle those before passing them to an <var>XmlDoc</var> update operation. For example, you may be able to use the <var class="term">Untranslatable</var> argument of the <var>[[EbcdicToUnicode (String function)\|EbcdicToUnicode]]</var> function.
	<li>A null character in an <var>XmlDoc</var> is serialized as an XML hexadecimal character reference: <code>&amp;#x0;</code>.		<li>A null character in an <var>XmlDoc</var> is serialized as an XML hexadecimal character reference: <code>&amp;amp;#x0;</code>.
	<li><var>AllowNull</var> is new as of <var class="product">[[Sirius Mods]]</var> Version 7.6.		<li><var>AllowNull</var> is new as of <var class="product">[[Sirius Mods]]</var> Version 7.6.
	</ul>		</ul>
Line 62:		Line 62:
	The Buddha dog says		The Buddha dog says
	<nowiki><!--substitute character is ?--></nowiki>		<nowiki><!--substitute character is ?--></nowiki>
	<a>nothingness: &amp;#x0;</a>		<a>nothingness: &amp;amp;#x0;</a>
	</zen>		</zen>
	</p>		</p>

JALWiccan: 1 revision

2011-05-24T17:27:02Z

1 revision

← Older revision	Revision as of 17:27, 24 May 2011
(No difference)

Goff: edits, tags and links

2011-05-24T17:27:01Z

edits, tags and links

← Older revision		Revision as of 17:27, 24 May 2011
Line 3:		Line 3:
	The <var>allowNull</var> property indicates whether or not the method object <var>XmlDoc</var> allows the deserialization of an XML document that contains nodes that have null characters (U+0000) in their values. A <var>[[Boolean]]</var> value of <code>True</code> allows such deserializations. The default value, <code>False</code>, cancels the request if such a deserialization is attempted.		The <var>allowNull</var> property indicates whether or not the method object <var>XmlDoc</var> allows the deserialization of an XML document that contains nodes that have null characters (U+0000) in their values. A <var>[[Boolean]]</var> value of <code>True</code> allows such deserializations. The default value, <code>False</code>, cancels the request if such a deserialization is attempted.
	<p>For example, the following <var>Element</var> node is acceptable for deserialization into an <var>XmlDoc</var> (for example, by using <var>[[LoadXml (XmlDoc/XmlNode function)\|LoadXml]]</var>) only if <var>AllowNull</var> is <code>True</code>:</p>		<p>For example, the following <var>Element</var> node is acceptable for deserialization into an <var>XmlDoc</var> (for example, by using <var>[[LoadXml (XmlDoc/XmlNode function)\|LoadXml]]</var>) only if <var>AllowNull</var> is <code>True</code>:</p>
	<p class="code"><a>Element contains null: &#0;</a>		<p class="code"><a>Element contains null: &amp;#0;</a>
	</p>		</p>
	<p>If <code>AllowNull=True</code>, null characters are also allowed for "direct setting" of a node's value using one of the many <var>Add</var> or </var>Insert</var> methods. For example:</p>		<p>If <code>AllowNull=True</code>, null characters are also allowed for "direct setting" of a node's value using one of the many <var>Add</var> or </var>Insert</var> methods. For example:</p>
Line 29:		Line 29:
	<li>Deserialization of Unicode characters that do not translate to EBCDIC is not allowed unless the <var>[[LoadXml (XmlDoc/XmlNode function)#allowUntrans\|AllowUntranslatable]]</var> deserialization option is used.		<li>Deserialization of Unicode characters that do not translate to EBCDIC is not allowed unless the <var>[[LoadXml (XmlDoc/XmlNode function)#allowUntrans\|AllowUntranslatable]]</var> deserialization option is used.
	<li>When providing EBCDIC characters to be stored in an <var>XmlDoc</var>, those EBCDIC characters must be translatable to Unicode. If you have EBCDIC strings that may not be translatable, you must handle those before passing them to an <var>XmlDoc</var> update operation. For example, you may be able to use the <var class="term">Untranslatable</var> argument of the <var>[[EbcdicToUnicode (String function)\|EbcdicToUnicode]]</var> function.		<li>When providing EBCDIC characters to be stored in an <var>XmlDoc</var>, those EBCDIC characters must be translatable to Unicode. If you have EBCDIC strings that may not be translatable, you must handle those before passing them to an <var>XmlDoc</var> update operation. For example, you may be able to use the <var class="term">Untranslatable</var> argument of the <var>[[EbcdicToUnicode (String function)\|EbcdicToUnicode]]</var> function.
	<li>A null character in an <var>XmlDoc</var> is serialized as an XML hexadecimal character reference: <code>&#x0;</code>.		<li>A null character in an <var>XmlDoc</var> is serialized as an XML hexadecimal character reference: <code>&amp;#x0;</code>.
	<li><var>AllowNull</var> is new as of <var class="product">[[Sirius Mods~~\|"Sirius Mods"~~]]</var> Version 7.6.		<li><var>AllowNull</var> is new as of <var class="product">[[Sirius Mods]]</var> Version 7.6.
	</ul>		</ul>

Line 62:		Line 62:
	The Buddha dog says		The Buddha dog says
	<nowiki><!--substitute character is ?--></nowiki>		<nowiki><!--substitute character is ?--></nowiki>
	<a>nothingness: &#x0;</a>		<a>nothingness: &amp;#x0;</a>
	</zen>		</zen>
	</p>		</p>

Goff: edits, tags and links

2011-05-19T10:09:41Z

edits, tags and links

← Older revision		Revision as of 10:09, 19 May 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:<tt>allowNull</tt> (<tt>XmlDoc</tt> property)}}		{{DISPLAYTITLE:<tt>allowNull</tt> (<tt>XmlDoc</tt> property)}}
	{{Template:XmlDoc:AllowNull subtitle}}		{{Template:XmlDoc:AllowNull subtitle}}
			The <var>allowNull</var> property indicates whether or not the method object <var>XmlDoc</var> allows the deserialization of an XML document that contains nodes that have null characters (U+0000) in their values. A <var>[[Boolean]]</var> value of <code>True</code> allows such deserializations. The default value, <code>False</code>, cancels the request if such a deserialization is attempted.
	~~This~~ property indicates whether or not the method object <var>XmlDoc</var> allows		<p>For example, the following <var>Element</var> node is acceptable for deserialization into an <var>XmlDoc</var> (for example, by using <var>[[LoadXml (XmlDoc/XmlNode function)\|LoadXml]]</var>) only if <var>AllowNull</var> is <code>True</code>:</p>
	the deserialization of an XML document that contains nodes
	that have null characters (U+0000) in their values.
	A <var>Boolean</var> value of <~~var~~>True</~~var~~> allows such deserializations.
	The default value, <~~var~~>False</~~var~~>,
	cancels the request if such a deserialization is attempted.

	For example, the following Element node is acceptable for deserialization
	into an <var>XmlDoc</var> (using ~~the~~ <var>[[LoadXml (XmlDoc/XmlNode function)\|LoadXml]]</var> ~~method, for example~~) only if <var>AllowNull</var>
	is <~~var~~>True</~~var~~>:
	<p class="code"><a>Element contains null: &#0;</a>		<p class="code"><a>Element contains null: &#0;</a>
	</p>		</p>
			<p>If <code>AllowNull=True</code>, null characters are also allowed for "direct setting" of a node's value using one of the many <var>Add</var> or </var>Insert</var> methods. For example:</p>
	If <code>AllowNull=True</code>, null characters are also allowed for "direct setting"
	of a node's value using one of the many Add or Insert methods.
	For example:
	<p class="code">%nod:AddElement('a', 'Element contains null:' With $X2C('00'))		<p class="code">%nod:AddElement('a', 'Element contains null:' With $X2C('00'))
	</p>		</p>
			<p>The default value of <var>AllowNull</var> is <code>False</code>.</p>

	~~The default value of <var>AllowNull</var> is <var>False</var>.~~

	~~<var>AllowNull</var> is new as of version 7.6 of the <var class="product">Sirius Mods</var>.~~
	==Syntax==		==Syntax==
	{{Template:XmlDoc:AllowNull syntax}}		{{Template:XmlDoc:AllowNull syntax}}
Line 38:		Line 24:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>Nodes that are added to an <var>XmlDoc</var> that has <code>AllowNull=True</code>		<li>Nodes that are added to an <var>XmlDoc</var> that has <code>AllowNull=True</code> may not then be the source node in a subtree copy (<var>[[AddSubtree (XmlDoc/XmlNode function)\|AddSubtree]]</var> or <var>[[InsertSubtreeBefore (XmlNode function)\|InsertSubtreeBefore]]</var>) to a target <var>XmlDoc</var> that has <code>AllowNull=False</code>.
	may not then be the source node in a subtree copy		<li>All Unicode characters except null can always be stored in an <var>XmlDoc</var>, so setting <var>AllowNull</var> to <code>True</code> means ''all'' Unicode characters can be stored. If you were using the
	(<var>[[AddSubtree (XmlDoc/XmlNode function)\|AddSubtree]]</var> or <var>[[InsertSubtreeBefore (XmlNode function)\|InsertSubtreeBefore]]</var>) to a target		now obsolete <code>InvalidChar=Allow</code> setting to allow null characters in an <var>XmlDoc</var>, you can use <code>AllowNull=True</code> instead.
	<var>XmlDoc</var> that has <code>AllowNull=False</code>.		<li>Deserialization of Unicode characters that do not translate to EBCDIC is not allowed unless the <var>[[LoadXml (XmlDoc/XmlNode function)#allowUntrans\|AllowUntranslatable]]</var> deserialization option is used.
	<li>All Unicode characters except null can always be stored		<li>When providing EBCDIC characters to be stored in an <var>XmlDoc</var>, those EBCDIC characters must be translatable to Unicode. If you have EBCDIC strings that may not be translatable, you must handle those before passing them to an <var>XmlDoc</var> update operation. For example, you may be able to use the <var class="term">Untranslatable</var> argument of the <var>[[EbcdicToUnicode (String function)\|EbcdicToUnicode]]</var> function.
	in an <var>XmlDoc</var>, so setting <var>AllowNull</var> to <~~var~~>True</~~var~~> means ''all''		<li>A null character in an <var>XmlDoc</var> is serialized as an XML hexadecimal character reference: <code>&#x0;</code>.
	Unicode characters can be stored.		<li><var>AllowNull</var> is new as of <var class="product">[[Sirius Mods\|"Sirius Mods"]]</var> Version 7.6.
	If you were using the
	now obsolete <code>InvalidChar=Allow</code> setting to allow null
	characters in an <var>XmlDoc</var>, you can use <code>AllowNull=True</code> instead.
	<li>Deserialization of Unicode characters that do not
	translate to EBCDIC is not allowed unless the <var>[[LoadXml (XmlDoc/XmlNode function)#allowUntrans\|AllowUntranslatable]]</var>
	deserialization option is used.
	<li>When providing EBCDIC characters to be stored in
	an <var>XmlDoc</var>, those EBCDIC characters must be translatable to
	Unicode.
	If you have EBCDIC strings that may not be translatable, you
	must handle those before passing them to an <var>XmlDoc</var> update operation.
	For example, you may be able to use the <var>Untranslatable</var>
	argument of the <var>[[EbcdicToUnicode (String function)\|EbcdicToUnicode]]</var> function.
	<li>A null character in an <var>XmlDoc</var> is serialized
	as an XML hexadecimal character reference: <code>&#x0;</code>.
	</ul>		</ul>

	==Examples==		==Examples==
			<ol><li>
	In the following request, an Ebcdic X'FF' character requires a replacement		In the following request, an Ebcdic X'FF' character requires a replacement to avoid request cancellation, but setting <var>AllowNull</var> to <code>True</code> lets a null be added to the <var>XmlDoc</var>.
	to avoid request cancellation,
	but setting <var>AllowNull</var> to <~~var~~>True</~~var~~> lets a null be added to the <var>XmlDoc</var>.
	<p class="code">Begin		<p class="code">Begin
	%d is object ~~Xmldoc~~ auto new		%d is object xmldoc auto new
	%n1 is object xmlnode		%n1 is object xmlnode
	%n2 is object xmlnode		%n2 is object xmlnode
	%n3 is object xmlnode		%n3 is object xmlnode
	%txt is string len 32		%txt is string len 32
	%uni is unicode		%uni is unicode

	%d:~~LoadXml~~('<zen>The Buddha dog says</zen>')		%d:[[LoadXml_(XmlDoc/XmlNode_function)\|loadXml]]('<zen>The Buddha dog says</zen>')
	%n1 = %d:~~SelectSingleNode~~('zen')		%n1 = %d:[[SelectSingleNode_(XmlDoc/XmlNode_function)\|selectSingleNode]]('zen')
	%txt = 'substitute character is ' ~~With~~ $X2C('FF')		%txt = 'substitute character is ' with $X2C('FF')
	%uni = %txt:EbcdicToUnicode(untranslatable='?')		%uni = %txt:[[EbcdicToUnicode (String function)\|ebcdicToUnicode]](untranslatable='?')
	%n2 = %n1:~~AddComment~~(%uni)		%n2 = %n1:[[AddComment_(XmlDoc/XmlNode_function)\|addComment]](%uni)
	printText {~} = {%n2:value}		[[PrintText statement\|printText]] {~} = {%n2:value}

	%d:allownull = true		%d:allownull = true
	%n3 = %n1:~~AddElement~~('a', 'nothingness: ' With $X2C('00'))		%n3 = %n1:[[AddElement_(XmlDoc/XmlNode_function)\|addElement]]('a', 'nothingness: ' With $X2C('00'))
	%d:print		%d:print
	end		end
	</p>		</p>
Line 91:		Line 61:
	<zen>		<zen>
	The Buddha dog says		The Buddha dog says
	<!--substitute character is ?-->		<nowiki><!--substitute character is ?--></nowiki>
	<a>nothingness: &#x0;</a>		<a>nothingness: &#x0;</a>
	</zen>		</zen>

Goff: fix "using boolean enumerations" link

2011-05-19T09:08:32Z

fix "using boolean enumerations" link

← Older revision		Revision as of 09:08, 19 May 2011
Line 29:		Line 29:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%currentBoolean</th>		<tr><th>%currentBoolean</th>
	<td>The <var>Boolean</var> enumeration value of <var class="term">doc</var>'s <var>AllowNull</var> property. For more information about these enumerations, see [[Using Boolean enumerations]]. </td></tr>		<td>The <var>Boolean</var> enumeration value of <var class="term">doc</var>'s <var>AllowNull</var> property. For more information about these enumerations, see [[Enumerations#Using_Boolean_enumerations\|"Using Boolean enumerations"]]. </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>
Line 35:		Line 35:
	<td>The <var>Boolean</var> value to assign to <var class="term">doc</var>'s <var>AllowNull</var> property.</td></tr>		<td>The <var>Boolean</var> value to assign to <var class="term">doc</var>'s <var>AllowNull</var> property.</td></tr>
	</table>		</table>

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

Dme at 17:55, 4 March 2011

2011-03-04T17:55:36Z

Dme at 16:35, 4 March 2011

2011-03-04T16:35:21Z

← Older revision		Revision as of 16:35, 4 March 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:<tt>~~AllowNull~~</tt> (<tt>XmlDoc</tt> property)}}		{{DISPLAYTITLE:<tt>allowNull</tt> (<tt>XmlDoc</tt> property)}}
	{{Template:XmlDoc:AllowNull subtitle}}		{{Template:XmlDoc:AllowNull subtitle}}

← Older revision		Revision as of 17:55, 4 March 2011
Line 5:		Line 5:
	the deserialization of an XML document that contains nodes		the deserialization of an XML document that contains nodes
	that have null characters (U+0000) in their values.		that have null characters (U+0000) in their values.
	A <var>Boolean</var> value of <~~code~~>True</~~code~~> allows such deserializations.		A <var>Boolean</var> value of <var>True</var> allows such deserializations.
	The default value, <~~code~~>False</~~code~~>,		The default value, <var>False</var>,
	cancels the request if such a deserialization is attempted.		cancels the request if such a deserialization is attempted.

	For example, the following Element node is acceptable for deserialization		For example, the following Element node is acceptable for deserialization
	into an <var>XmlDoc</var> (using the <var>[[LoadXml (XmlDoc/XmlNode function)\|LoadXml]]</var> method, for example) only if <var>AllowNull</var>		into an <var>XmlDoc</var> (using the <var>[[LoadXml (XmlDoc/XmlNode function)\|LoadXml]]</var> method, for example) only if <var>AllowNull</var>
	is <~~code~~>True</~~code~~>:		is <var>True</var>:
	<p class="code"><a>Element contains null: &#0;</a>		<p class="code"><a>Element contains null: &#0;</a>
	</p>		</p>
Line 21:		Line 21:
	</p>		</p>

	The default value of <var>AllowNull</var> is <~~code~~>False</~~code~~>.		The default value of <var>AllowNull</var> is <var>False</var>.

	<var>AllowNull</var> is new as of version 7.6 of the ''Sirius Mods''.		<var>AllowNull</var> is new as of version 7.6 of the <var class="product">Sirius Mods</var>.
	==Syntax==		==Syntax==
	{{Template:XmlDoc:AllowNull syntax}}		{{Template:XmlDoc:AllowNull syntax}}
Line 43:		Line 43:
	<var>XmlDoc</var> that has <code>AllowNull=False</code>.		<var>XmlDoc</var> that has <code>AllowNull=False</code>.
	<li>All Unicode characters except null can always be stored		<li>All Unicode characters except null can always be stored
	in an <var>XmlDoc</var>, so setting <var>AllowNull</var> to <~~code~~>True</~~code~~> means ''all''		in an <var>XmlDoc</var>, so setting <var>AllowNull</var> to <var>True</var> means ''all''
	Unicode characters can be stored.		Unicode characters can be stored.
	If you were using the		If you were using the
Line 49:		Line 49:
	characters in an <var>XmlDoc</var>, you can use <code>AllowNull=True</code> instead.		characters in an <var>XmlDoc</var>, you can use <code>AllowNull=True</code> instead.
	<li>Deserialization of Unicode characters that do not		<li>Deserialization of Unicode characters that do not
	translate to EBCDIC is not allowed unless the <~~code~~>[[LoadXml (XmlDoc/XmlNode function)#allowUntrans\|AllowUntranslatable]]</~~code~~>		translate to EBCDIC is not allowed unless the <var>[[LoadXml (XmlDoc/XmlNode function)#allowUntrans\|AllowUntranslatable]]</var>
	deserialization option is used.		deserialization option is used.
	<li>When providing EBCDIC characters to be stored in		<li>When providing EBCDIC characters to be stored in
Line 65:		Line 65:
	In the following request, an Ebcdic X'FF' character requires a replacement		In the following request, an Ebcdic X'FF' character requires a replacement
	to avoid request cancellation,		to avoid request cancellation,
	but setting <var>AllowNull</var> to <~~code~~>True</~~code~~> lets a null be added to the <var>XmlDoc</var>.		but setting <var>AllowNull</var> to <var>True</var> lets a null be added to the <var>XmlDoc</var>.
	<p class="code">Begin		<p class="code">Begin
	%d is object Xmldoc auto new		%d is object Xmldoc auto new