FOR 子句 (Transact-SQL)

FOR 子句用来指定 BROWSE 或 XML 选项。BROWSE 和 XML 是无关的选项。

Transact-SQL 语法约定

语法

[ FOR { BROWSE | <XML> } ]
<XML> ::=
XML 
{ 
    { RAW [ ( 'ElementName' ) ] | AUTO } 
    [ 
        <CommonDirectives> 
        [ , { XMLDATA | XMLSCHEMA [ ( 'TargetNameSpaceURI' ) ] } ] 
        [ , ELEMENTS [ XSINIL | ABSENT ] 
    ]
  | EXPLICIT 
    [ 
        <CommonDirectives> 
        [ , XMLDATA ] 
    ]
  | PATH [ ( 'ElementName' ) ] 
    [
        <CommonDirectives> 
        [ , ELEMENTS [ XSINIL | ABSENT ] ]
    ]
} 

<CommonDirectives> ::= 
[ , BINARY BASE64 ]
[ , TYPE ]
[ , ROOT [ ( 'RootName' ) ] ]

参数

• BROWSE
  指定可以在查看 DB-Library 浏览模式游标中的数据时进行更新。如果表包括 timestamp 列，并且表有唯一索引，而且在发送到 SQL Server 实例的 SELECT 语句中 FOR BROWSE 选项位于末尾，则可以在应用程序中浏览该表。

  注意：
  不能在包括 FOR BROWSE 选项的 SELECT 语句中使用 <lock_hint> HOLDLOCK。

  FOR BROWSE 不能出现在由 UNION 运算符所联接的 SELECT 语句中。

  注意：
  如果表的唯一索引键列可为空，并且表在外部联接的内侧，则浏览模式不支持索引。

• XML
  指定以 XML 文档返回查询的结果。必须指定下列 XML 模式之一：RAW、AUTO、EXPLICIT。有关 XML 数据和 SQL Server 的详细信息，请参阅使用 FOR XML 构造 XML。

• RAW [ ('ElementName') ]
  获得查询结果并将结果集内的每一行转换为以一般标识符 <row /> 作为元素标记的 XML 元素。（可选）可以为该行元素指定名称。所得到的 XML 输出将使用指定的 ElementName 作为为每一行生成的行元素。有关详细信息，请参阅使用 RAW 模式和 RAW 模式的增强功能。

• AUTO
  以简单的嵌套 XML 树返回查询结果。FROM 子句中每个在 SELECT 子句中至少列出一次的表都被表示为一个 XML 元素。SELECT 子句中列出的列映射到适当的元素属性。有关详细信息，请参阅使用 AUTO 模式和 AUTO 模式的增强功能。

• EXPLICIT
  指定显式定义结果 XML 树的形状。使用该模式要求必须以一种特定的方式编写查询，即显式指定与想要的嵌套有关的其他信息。有关详细信息，请参阅使用 EXPLICIT 模式和 EXPLICIT 模式的增强功能。

• XMLDATA
  返回内联 XDR 架构，但不将根元素添加到结果中。如果指定了 XMLDATA，则 XDR 架构将被追加到文档末尾。

• XMLSCHEMA [ ('TargetNameSpaceURI') ]
  返回内联 XSD 架构。如果指定该指令（用于返回架构中指定的命名空间），则可以选择指定目标命名空间 URI。有关详细信息，请参阅内联 XSD 架构生成。

• ELEMENTS
  指定列作为子元素返回。否则，列将映射到 XML 属性。只在 RAW、AUTO 和 PATH 模式中支持该选项。有关详细信息，请参阅 RAW 模式的增强功能。

• XSINIL
  指定为 NULL 列值创建其 xsi:nil 属性设置为 True 的元素。该选项只能与 ELEMENTS 指令一起指定。有关详细信息，请参阅使用 XSINIL 参数生成 NULL 值对应的元素。

• ABSENT
  指示对于空列值，将不在 XML 结果中添加对应的 XML 元素。该选项只能与 ELEMENTS 一起指定。

• PATH [ ('ElementName') ]
  为结果集中的每一行生成 <row> 元素包装。（可选）可以为 <row> 元素包装指定元素名称。如果提供了空字符串（例如 FOR XML PATH ('')），则不生成包装元素。使用 PATH 可能为使用 EXPLICIT 指令所编写的查询提供更简单的代替方案。有关详细信息，请参阅使用 PATH 模式。

• BINARY BASE64
  指定查询返回二进制 base64 编码格式的二进制数据。使用 RAW 和 EXPLICIT 模式检索二进制数据时，必须指定该选项。这是 AUTO 模式中的默认值。

• TYPE
  指定查询以 xml 类型返回结果。有关详细信息，请参阅 FOR XML 查询中的 TYPE 指令。

• ROOT [ ('RootName') ]
  指定将一个顶级元素添加到结果 XML 中。（可选）可以指定要生成的根元素名称。如果不指定可选的根名称，则添加默认的 <root> 元素。

示例

以下示例指定具有 TYPE 和 XMLSCHEMA 选项的 FOR XML AUTO。由于有 TYPE 选项，因此，结果集将作为 xml 类型返回到客户端。XMLSCHEMA 选项指定在所返回的 XML 数据中包括内联 XSD 架构，而 ELEMENTS 选项指定 XML 结果是以元素为中心的。

USE AdventureWorks;
GO
SELECT ContactID, FirstName, LastName, Phone
FROM Person.Contact
WHERE LastName LIKE 'G%'
ORDER BY LastName, FirstName 
FOR XML AUTO, TYPE, XMLSCHEMA, ELEMENTS XSINIL;

请参阅

参考

SELECT (Transact-SQL)

其他资源

使用 FOR XML 和 OPENXML 发布和处理 XML 数据

帮助和信息

获取 SQL Server 2005 帮助