xml.StaxWriter.attributeNS

Writes an XML namespace qualified attribute to the StaxWriter stream.

Syntax

attributeNS(
   name STRING,
   ns STRING,
   value STRING )
  1. name is the local name of the XML attribute, cannot be NULL.
  2. ns is the namespace URI of the XML attribute, cannot be NULL.
  3. value is the value of the XML attribute, cannot be NULL.

Usage

Attributes can only be written on the StaxWriter stream if it points to a START_ELEMENT or an EMPTY_ELEMENT, otherwise the operation fails with an exception; that is, this method can only be called after a startElement, startElementNS, emptyElement, emptyElementNS, or attribute and attributeNS.

If namespace URI has not been bound to a prefix with one of the methods setPrefix, declareNamespace, setDefaultNamespace or declareDefaultNamespace, the operation fails with an exception.

In case of error, the method throws an exception and sets the STATUS variable. Depending on the error, a human-readable description of the problem is available in the SQLCA.SQLERRM register. See Error handling in GWS calls (STATUS).