@XMLGetAllContent

Diese @Function ermittelt den gesamten Textinhalt eines XML-Knotens einschließlich des Inhalts aller untergeordneten Elemente.
Der Inhalt wird entsprechend den für das XML-Handle gesetzten Output-Flags in den gewünschten Zeichensatz konvertiert.
Über den optionalen Parameter Options wird festgelegt, ob der Inhalt als Text oder als Binärpuffer zurückgegeben wird.

VSPECHXMLNODE XMLN:
Handle des XML-Knotens, dessen gesamter Inhalt ermittelt werden soll.
XMLN muss ein gültiges VSPECHXMLNODE (XMLN) Handle enthalten, das auf einen XML-Knoten verweist.

TEXT Options (Optional):
Legt den Datentyp des zurückgegebenen Attributwertes fest.

Option : Bedeutung
"A" : Gibt den Attributwert als TEXT zurück.
"B" : Gibt den Attributwert als VSPECBINBUFFER zurück.

Wird Options nicht angegeben, entspricht dies Option "A".
Bei Option "A" darf der zurückgegebene Wert die maximale Größe eines Text-Items nicht überschreiten.
Bei Option "B" können Inhalte bis zu einer maximalen Größe von 100 MB zurückgegeben werden.

Return-Wert:
Bei erfolgreicher Ausführung liefert die @Function den gesamten Textinhalt des XML-Knotens entsprechend Options als TEXT oder VSPECBINBUFFER zurück.
Dabei wird nicht nur der direkte Textinhalt des Knotens berücksichtigt, sondern auch der Textinhalt aller untergeordneten Elemente.
Bei einem ungültigen XML-Node-Handle, einer ungültigen Option oder einem Fehler bei der Zeichensatzkonvertierung liefert die @Function @ERROR.

Beispiel: @XMLGetAllContent(XMLN);

XML := "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" +
"<customer>" +
" <name>Example GmbH</name>" +
" <city>Berlin</city>" +
"</customer>";

hXMLD := @XMLParse(XML);
hXMLRoot := @XMLGetRoot(hXMLD);
Content := @XMLGetAllContent(hXMLRoot);
@XMLRelease(hXMLD);

Das Beispiel ermittelt den gesamten Textinhalt des Root-Elements. Content enthält anschließend den Inhalt der Elemente "<name>" und "<city>".

Beispiel: @XMLGetAllContent(XMLN;Options);

XML := "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" +
"<customer>" +
" <name>Example GmbH</name>" +
" <city>Berlin</city>" +
"</customer>";

hXMLD := @XMLParse(XML);
hXMLRoot := @XMLGetRoot(hXMLD);
Content := @XMLGetAllContent(hXMLRoot;"B");
@DestroyBuffer(Content);
@XMLRelease(hXMLD);

Das Beispiel gibt den gesamten Textinhalt des XML-Knotens als VSPECBINBUFFER zurück.