Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
生成一个 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/2008 XMLFOREST 是可选 SQL/2008 语言功能 X032 的组成部分。SQL Anywhere 不支持可选的 XMLNAMESPACES 子句或 OPTION 子句与 XMLFOREST 函数结合使用。
以下示例为每个职员的名和姓生成了一个 XML 元素。
SELECT EmployeeID, XMLFOREST( GivenName, Surname ) AS "Employee Name" FROM Employees;