XMLFOREST-Funktion [Zeichenfolge]

Erzeugt einen Wald von XML-Elementen.

Syntax

XMLFOREST( Elementinhalt-Ausdruck [ AS Elementname ],... )

Parameter

Elementinhalt-Ausdruck Eine Zeichenfolge. Für jedes angegebene Elementinhalt-Ausdruck-Argument wird ein Element erzeugt. Der Wert vom Elementinhalt-Ausdruck wird der Inhalt des Argumentes. Wenn Sie z.B. die Spalte EmployeeID aus der Tabelle Employees für dieses Argument angeben, wird für jeden Wert in der Tabelle ein <EmployeeID>-Element erzeugt, das einen EmployeeID-Wert enthält.
Geben Sie das Elementname-Argument an, wenn Sie dem Element einen anderen Namen zuordnen wollen als den Elementinhalt-Ausdruck, sonst wird standardmäßig der Name Elementinhalt-Ausdruck verwendet.

Rückgabe

XML

Bemerkungen

Produziert einen Wald von XML-Elementen. In einem nicht syntaktisch analysierten Dokument bezieht sich "Wald" auf die Vielzahl der Stammknoten innerhalb des Dokumentes. Wenn alle Argumente für die XMLFOREST-Funktion gleich NULL sind, wird NULL zurückgegeben. Wenn nur einige Werte NULL sind, wird NULL nicht in das Ergebnis einbezogen. Der Elementeninhalt wird in Anführungszeichen gesetzt, es sei denn, der Datentyp ist XML. Sie können mit der XMLFOREST-Funktion keine Attribute angeben. Verwenden Sie die Funktion XMLELEMENT, wenn Sie Attribute für erzeugte Elemente angeben wollen.

Weitere Hinweise zur Funktion XMLELEMENT finden Sie unter XMLELEMENT-Funktion [Zeichenfolge].

Elementnamen werden in Escapezeichen gesetzt, es sei denn, der Datentyp ist XML.

Wenn ein korrekt aufgebautes XML-Dokument gefordert ist, müssen Sie sicherstellen, dass Ihre Abfrage so geschrieben ist, dass nur ein Wurzelelement erzeugt wird.

Daten in den Spalten BINARY, LONG BINARY, IMAGE und VARBINARY werden automatisch im Base64-kodierten Format zurückgegeben, wenn Sie eine Abfrage ausführen, die XMLFOREST enthält.

Siehe auch

Standards und Kompatibilität

Teil des SQL/XML-Standardentwurfs

Beispiel

Die folgende Anweisung produziert ein XML-Element für den Vor- und Nachnamen eines jeden Mitarbeiters.

SELECT EmployeeID,
       XMLFOREST( GivenName, Surname )
       AS "Employee Name"
FROM Employees;

Kommentieren Sie diese Seite in DocCommentXchange.
Senden Sie uns Feedback über diese Seite via E-Mail.