XMLGEN 函数 [String]

基于 XQuery 构造函数生成一个 XML 值。

语法

XMLGEN( xquery-constructor, content-expression [ AS variable-name ],... )

参数

xquery-constructor XQuery 构造程序。XQuery 构造函数为在 XQuery 语言中定义的一项。它给出了基于 XQuery 表达式构造 XML 元素的语法。xquery-constructor 参数必须为具有一个或多个变量引用的格式正确的 XML 文档。变量引用要放在大括号内，并且带有前缀 $，两侧没有空格。例如：
SELECT XMLGEN( '<a>{$x}</a>', 1 AS x );

content-expression 一个变量。可以指定多个 content-expression 参数。此可选的 variable-name 参数用于对变量命名。例如，

SELECT XMLGEN( '<emp EmployeeID="{$EmployeeID}"><StartDate>{$x}</StartDate></emp>', EmployeeID, StartDate AS x ) FROM Employees;

返回值

XML

注释

XMLGEN 函数不支持 XQuery 说明中定义的计算构造函数。

执行包含 XMLGEN 函数的查询时，将自动以 base64 编码格式返回 BINARY、LONG BINARY、IMAGE 和 VARBINARY 列中的数据。

始终将元素内容转义，除非数据类型为 XML。非法的 XML 元素和特性名也会被转义。

有关转义和 XMLGEN 函数的信息，请参见无效的名称和 SQL/XML。

另请参见

标准和兼容性

SQL/XML 标准草案的一部分。

示例

以下示例会为每个雇员生成 <emp>、<Surname>、<GivenName> 和 <StartDate> 元素。

SELECT XMLGEN( '<emp EmployeeID="{$EmployeeID}">
                  <Surname>="{$Surname}"</Surname>
                  <GivenName>="{$GivenName}"</GivenName>
                  <StartDate>="{$StartDate}"</StartDate>
               </emp>',
               EmployeeID,
               Surname,
               GivenName,
               StartDate
              ) AS employee_list
FROM Employees;