Try OpenEdge Now
skip to main content
Working with XML
Reading XML Documents with the Simple API for XML (SAX) : SAX API reference : SAX callback reference : StartElement
 
StartElement
Invoked when the XML parser detects the beginning of an element.

Syntax

PROCEDURE StartElement:
DEFINE INPUT PARAMETER namespaceURI AS CHARACTER.
DEFINE INPUT PARAMETER localName AS CHARACTER.
DEFINE INPUT PARAMETER qName AS CHARACTER.
DEFINE INPUT PARAMETER attributes AS HANDLE.
namespaceURI
A character string indicating the namespace URI of the element. If namespace processing is not enabled or the element is not part of a namespace, the string is of length zero.
localName
A character string indicating the non-prefixed element name. If namespace processing is not enabled, the string is of length zero.
qName
A character string indicating the actual name of the element in the XML source. If the name has a prefix, qName includes it, whether or not namespace processing is enabled.
attributes
A handle to a SAX-attributes object, which provides access to all attributes specified for the element. If the element has no attributes, attributes is still a valid handle, and the NUM-ITEMS attribute is zero.
For every invocation of StartElement, there is a corresponding invocation of EndElement.
The contents of the element are reported in sequential order before the corresponding EndElement is invoked.
When StartElement returns, the SAX-attributes object, which was created by the AVM is deleted by the AVM.
Note: If the application deletes it first, however, no harm is done.