IDLffXMLSAX Properties

IDLffXMLSAX objects have the following properties in addition to properties inherited from any superclasses. Properties with the word “Yes” in the “Get” column of the property table can be retrieved via IDLffXMLSAX::GetProperty. Properties with the word “Yes” in the “Init” column of the property table can be set via IDLffXMLSAX::Init. Properties with the word “Yes” in the “Set” column in the property table can be set via IDLffXMLSAX::SetProperty.

Note: For a discussion of the property description tables shown below, see Modifying Object Property Descriptions.

Objects of this class have the following properties.

FILENAME

A string containing the filename of the XML file being parsed.

Note: This property is only available during a parse operation.

Property Type

String

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

NAMESPACE_PREFIXES

A Boolean value indicating whether namespace prefixes are enabled. Namespace prefixes are enabled if this property is set to true. By default, namespace prefixes are disabled.

Property Type

Boolean

Name String

not displayed

Get: Yes

Set: Yes

Init:Yes

Registered: No

PARSER_LOCATION

A two-element array containing the approximate location of the parser within the entity being parsed. The first element of the array is set to the line number and the second element is set to the column number.

Note: This property is only available during a parse operation.

Property Type

Array

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

PARSER_PUBLICID

A string containing the Public ID for the entity being parsed, if it is available. If the Public ID is not available, an empty string is returned.

Note: This property is only available during a parse operation.

Property Type

String

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

PARSER_URI

A string containing the base URI (System ID) for the entity being parsed, if it is available. If the value is available, it is always an absolute URI. If the System ID is not available, an empty string is returned.

Note: This property can be used to identify the document or external entity in diagnostics, or to resolve relative URIs. However, it is only available during a parse operation.

Property Type

String

Name String

not displayed

Get: Yes

Set: No

Init:No

Registered: No

SCHEMA_CHECKING

An integer value to indicating the type of validation the parser should perform. XML Schemas describe the structure and allowed contents of an XML document. Schemas are more robust than, and are envisioned as a replacement for, DTDs. By default, the parser will validate the parsed XML file against the specified schema, if one is provided. If no schema is provided, no validation will occur. Possible values are:

0

No validation.

1

Validate only if a schema is provided. This is the default value.

2

Perform full schema constraint checking, if a schema is provided. This feature checks the schema grammar itself for additional errors. It does not affect the level of checking performed on document instances that use schema grammars.

 

Property Type

Integer

Name String

not displayed

Get: Yes

Set: Yes

Init:Yes

Registered: No

VALIDATION_MODE

An integer value indicating the type of XML validation that the parser should perform. XML Document Type Definitions (DTDs) describe the structure and allowed contents of an XML document. By default, the parser will validate the parsed XML file against the specified DTD, if one is provided; if no DTD specification is provided, no validation will occur. Possible values are:

0

  

1

Validate only if a DTD is provided. This is the default value.

2

Always perform validation. If this option is in force and no DTD is provided, every XML element in the document will generate an error.

Property Type

Integer

Name String

not displayed

Get: Yes

Set: Yes

Init:Yes

Registered: No