FOR XML AUTO

AUTO 模式会在 XML 文档中生成嵌套的元素。

省略 ELEMENTS 子句时，SELECT 列表中引用的每一个表在生成的 XML 中都会表示为一个元素。嵌套的顺序基于 SELECT 列表中引用列的顺序而定。为 SELECT 列表中的每个列创建一个属性。

存在 ELEMENTS 子句时，SELECT 列表中引用的每一个表和列在生成的 XML 中都会表示为一个元素。嵌套的顺序基于 SELECT 列表中引用列的顺序而定。为 SELECT 列表中的每个列创建一个元素。

语法

FOR XML AUTO[, ELEMENTS ]

ELEMENTS 让 FOR XML AUTO 为结果中的每一列都生成一个 XML 元素，而不是生成一个属性。例如：

SELECT Employees.EmployeeID, Departments.DepartmentName FROM Employees JOIN Departments ON Employees.DepartmentID=Departments.DepartmentID ORDER BY EmployeeID FOR XML AUTO, ELEMENTS;

在本例中，结果集中的每一列都会作为一个单独的元素返回，而不是作为 <Employees> 或 <Departments> 元素的属性返回。如果有 NULL 值，生成的 XML 文档中就会忽略该元素。

<Employees>
   <EmployeeID>102</EmployeeID>
   <Departments>
      <DepartmentName>R &amp; D</DepartmentName>
   </Departments>
</Employees> 
<Employees>
   <EmployeeID>105</EmployeeID>
   <Departments>
      <DepartmentName>R &amp; D</DepartmentName>
   </Departments>
</Employees> 
<Employees>
   <EmployeeID>129</EmployeeID>
   <Departments>
   <DepartmentName>Sales</DepartmentName>
   </Departments>
</Employees>
...

用法

在您使用 FOR XML AUTO 执行查询时，BINARY、LONG BINARY、IMAGE 和 VARBINARY 列中的数据会自动以 base64 编码格式返回。缺省情况下，结果中会忽略 NULL 值。通过将 for_xml_null_treatment 选项设置为 EMPTY，您可以将 NULL 值作为空属性返回。

除非另有要求，否则数据库服务器返回表中行的顺序没有任何意义。如果您希望结果按某种特定顺序显示，或者，对于有多个子项的父元素，在查询中加入 ORDER BY 子句，以让所有子项都相邻。如果您不指定 ORDER BY 子句，结果的嵌套就会取决于优化程序所选择的计划，而且您可能得不到需要的嵌套。

FOR XML AUTO 不会返回结构完好的 XML 文档，因为该文档没有单一的根节点。如果需要 <root> 元素，可以使用 XMLELEMENT 函数插入一个。例如：

SELECT XMLELEMENT( NAME root,
                   (SELECT EmployeeID AS id, GivenName AS name
                   FROM Employees FOR XML AUTO ) );

通过指定别名，您可以更改 XML 文档中使用的属性名或元素名。以下查询会将 ID 属性重命名为 product_ID：

SELECT ID AS product_ID
FROM Products
WHERE Color='Black'
FOR XML AUTO;

生成的 XML 如下：

<Products product_ID="302"/>
<Products product_ID="400"/>
<Products product_ID="501"/>
<Products product_ID="700"/>

您也可以用别名来重命名表。以下查询将表重命名为 product_info：

SELECT ID AS product_ID
FROM Products AS product_info
WHERE Color='Black'
FOR XML AUTO;

生成的 XML 如下：

<product_info product_ID="302"/>
<product_info product_ID="400"/>
<product_info product_ID="501"/>
<product_info product_ID="700"/>

示例

以下查询所生成的 XML 同时包含 <employee> 元素和 <department> 元素，其中 <employee> 元素（在 SELECT 列表中列在第一位的表）是 <department> 元素的父项。

SELECT EmployeeID, DepartmentName
FROM Employees AS employee 
JOIN Departments AS department
   ON employee.DepartmentID=department.DepartmentID
ORDER BY EmployeeID
FOR XML AUTO;

以上查询将生成以下 XML：

<employee EmployeeID="102">
   <department DepartmentName="R &amp; D"/>
</employee>
<employee EmployeeID="105">
   <department DepartmentName="R &amp; D"/>
</employee>
<employee EmployeeID="129">
   <department DepartmentName="Sales;"/>
</employee>
<employee EmployeeID="148">
   <department DepartmentName="Finance;"/>
</employee>
...

如果您按以下所示更改 SELECT 列表中列的顺序：

SELECT DepartmentName, EmployeeID
FROM Employees AS employee JOIN Departments AS department
   ON employee.DepartmentID=department.DepartmentID
ORDER BY 1, 2
FOR XML AUTO;

结果会如下所示嵌套：

<department DepartmentName="Finance">
   <employee EmployeeID="148"/>
   <employee EmployeeID="390"/>
   <employee EmployeeID="586"/>
   ...
</department> 
<department DepartmentName="Marketing">
   <employee EmployeeID="184"/>
   <employee EmployeeID="207"/>
   <employee EmployeeID="318"/>
   ...
</department>
...

为该查询生成的 XML 还是同时包含 <employee> 元素和 <department> 元素，但这一次，<department> 元素是 <employee> 元素的父项。

另请参见

使用DocCommentXchange讨论此页。

FOR XML AUTO

语法

参数

用法

示例

另请参见