#include <DbXml.hpp> virtual void XmlEventWriter::writeStartEntity(const unsigned char *name bool expandedInfoFollows)
Write StartEntityReference event to the XmlEventWriter . This event must be followed, later in the document, by a call to XmlEventWriter::writeEndEntity. Writing of StartEntityReference and EndEntityReference events is optional, but helpful for round-tripping of documents. A given implementation of XmlEventWriter may safely ignore such events.
The XmlEventWriter::writeStartEntity
method
may fail and throw
XmlException
, encapsulating one of the
following non-zero errors:
An error occurred during processing of an XmlEventWriter object. Most likely the error is attempting to write a type or value that is not valid in the current state of the object.