Standalone (XmlDoc property)

From m204wiki
Revision as of 17:50, 22 January 2011 by Wiccan (talk | contribs) (1 revision)
Jump to navigation Jump to search

Standalone specification in "XML declaration" (XmlDoc class)

Standalone is a member of the XmlDoc class.

This property indicates the value of standalone in the "XML declaration," if any, at the beginning of the serialized XML document.

Syntax

%currentString = doc:Standalone doc:Standalone = newString

Syntax terms

%curr The string value of doc's Standalone property.
doc An XmlDoc object expression.
newvalue The string value to assign to doc's Standalone property.

Usage notes

  • The only values to which you may set the Standalone property are:
    • The null string
    • yes
    • no

    The initial value of the property is the null string.

  • If a document is deserialized into an XmlDoc, the value of the Standalone property of the XmlDoc will be the value specified for standalone in the "XML declaration" of the document, if there was one. The possible Standalone values after deserialization are:
    • The null string
    • yes
    • no
  • Standalone may be set to a non-null string only if the value of the Version property (??Version) is also a non-null string.

Example

The following example sets the Version and Standalone properties:

    Begin
    %doc Object XmlDoc
    %doc:LoadXml('<a/>')
    %doc:Version = '1.0'
    %doc:Standalone = 'yes'
    %doc:Print
    End

The example result follows:

    <?xml version="1.0" standalone="yes"?>
    <a/>

Request-Cancellation Errors (for set method)

  • Version property is the null string, and newvalue is not the null string.
  • newvalue is invalid.