Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » SQL Anywhere 服务器 - SQL 参考 » 使用 SQL » SQL 函数 » SQL 函数 (P-Z)

 

XMLFOREST 函数 [String]

生成一个 XML 元素林。

语法
XMLFOREST( element-content-expression [ AS element-name ],... )
参数
  • element-content-expression   一个字符串。对每个所指定的 element-content-expression 参数生成一个元素。element-content-expression 值将成为元素的内容。例如,如果为此参数指定 Employees 表中的 EmployeeID 列,则将为此表中的每个值生成一个包含 EmployeeID 值的 <EmployeeID> 元素。

    如果要给元素指派 element-content-expression 以外的名称,请指定 element-name 参数,否则元素名在缺省情况下将是 element-content-expression 的名称。

返回值

XML

注释

生成一个 XML 元素林。在一个未被分析的 XML 文档中,元素林是指文档中的多个根节点。当 XMLFOREST 函数的所有参数都为 NULL 时,返回 NULL 值。当仅有某些值为 NULL 时,NULL 值将被从结果中忽略。始终将元素内容加上引号,除非数据类型为 XML。不能使用 XMLFOREST 函数来指定特性。如果要指定所生成元素的特性,请使用 XMLELEMENT 函数。

有关 XMLELEMENT 函数的详细信息,请参见XMLELEMENT 函数 [String]

始终将元素名称转义,除非数据类型为 XML。

如果您要求格式正确的 XML 文档,则必须确保编写查询以生成单个根元素。

当执行一个包含 XMLFOREST 的查询时,BINARY、LONG BINARY、IMAGE 和 VARBINARY 列中的数据将被自动以 base64 编码格式返回。

另请参见
标准和兼容性
  • SQL/XML 标准草案的一部分。

示例

以下示例为每个职员的名和姓生成了一个 XML 元素。

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