XMLElement() (Funktion)

Die Funktion XMLElement() erstellt ein XML-Element. In der Regel verschachteln Sie die Funktion XMLElement(), um ein hierarchisch strukturiertes XML-Dokument zu erzeugen.

Syntax

Die Funktion XMLElement() hat folgende Syntax:

XML = XMLElement(varchar name, [XML_Attrib attrib,] varchar value);

Der Wert " name gibt den Namen des umschließenden Tags für das XML-Element an. Wenn die von Ihnen angegebene Kennung NULL ist, wird kein Element zurückgegeben. Bei dem Namen darf es sich im Unterschied zur SQL/XML-Spezifikation nicht um einen Spaltennamen oder eine Spaltenreferenz handeln.

Ein oder mehrere optionale " attrib geben ein oder mehrere Name-Wert-Paare an, die Attribute für das XML-Element bilden.

Der Wert " input gibt den Inhalt des neuen XML-Elements an. Bei diesem Element kann es sich um einen skalaren Wert oder einen verschachtelten Aufruf der Funktion XMLElement() handeln.

Rückgabe

Die Funktion gibt den Typ XML zurück. Sie gibt eine kompilierte Darstellung eines XML-Elements mit dem angegebenen Namen, dem Inhalt und optional einer Sammlung von Attributen zurück. Sie erstellt keine Prologinformationen.

Beispiel

Betrachten Sie das folgende Beispiel:

select XMLElement('Parent', XMLElement('Child', 'Child text'));

Mit diesem Beispiel wird ein XML-Wert mit dem folgenden Inhalt erstellt:

<Parent><Child>Child text</Child></Parent>

Sie können eine Abfrage wie die folgende verwenden, um den XML-Inhalt anzuzeigen:

select XMLserialize(XMLElement('Parent', XMLElement('Child', 'Child text')));
                XMLSERIALIZE
--------------------------------------------
 <Parent><Child>Child text</Child></Parent>
(1 row)