User Guide

456 Chapter 6: ActionScript Core Classes

XML.docTypeDecl

Availability

Flash Player 5.

Usage

my_xml

.docTypeDecl:String

Description

Property; specifies information about the XML document’s DOCTYPE declaration. After the XML

text has been parsed into an XML object, the

XML.docTypeDecl property of the XML object is

set to the text of the XML document’s

DOCTYPE declaration (for example, <!DOCTYPE greeting

SYSTEM "hello.dtd">

). This property is set using a string representation of the DOCTYPE

declaration, not an XML node object.

The ActionScript XML parser is not a validating parser. The

DOCTYPE declaration is read by the

parser and stored in the

XML.docTypeDecl property, but no DTD validation is performed.

If no

DOCTYPE declaration was encountered during a parse operation, the XML.docTypeDecl

property is set to

undefined. The XML.toString() method outputs the contents

XML.docTypeDecl immediately after the XML declaration stored in XML.xmlDecl, and before

any other text in the XML object. If

XML.docTypeDecl is undefined, no DOCTYPE declaration is

output.

Example

The following example uses the XML.docTypeDecl property to set the DOCTYPE declaration for an

XML object:

my_xml.docTypeDecl = "<!DOCTYPE greeting SYSTEM \"hello.dtd\">";