SQL Server 的For XML及sp_xml_preparedocument

下面摘自MS SQL 的帮助文档。

在 FOR 子句中指定 XML 模式的基本语法为：

FOR XML mode [, XMLDATA] [, ELEMENTS][, BINARY BASE64]

参数

XML mode 指定 XML 模式。XML 模式决定所得到的 XML 的形式。 mode 可以是 RAW、AUTO 或 EXPLICIT。 XMLDATA 指定应返回 XML-Data 架构。文档的架构被预先设计为内嵌式架构。 ELEMENTS 如果指定 ELEMENTS 选项，则列作为子元素返回。否则，列将映射到 XML 特性。只有在 AUTO 模式下才支持该选项。 BINARY BASE64 如果指定 BINARY Base64 选项，则查询所返回的任何二进制数据都用 base64 编码格式表示。使用 RAW 和 EXPLICIT 模式检索二进制数据时，必须指定该选项。在 AUTO 模式中，默认情况下将二进制数据作为引用返回。

一、 使用AUTO模式

 
 
 
SELECT Name,Pwd,Type
            FROM Users
            WHERE Type = 3 FOR XML AUTO
	结果:
		<Users Name="123" Pwd="123" Type="3" />
		<Users Name=“www” Pwd=“www” Type=“3” />


AUTO模式中可以使用ELEMENTS选项，使用该选项可以生成以元素为中心的Xml表示，默认为属性方式，不过属性方式节省空间。
需要注意的是使用ELEMENTS选项是一种全是或全否的形式，不能得到一部分是以元素表示而另一部分以属性表示的Xml数据。
二、使用RAW模式 
	在RAW模式中，不能使用ELEMENTS选项。 

	  
  
  
SELECT Name,Pwd,Type
            FROM Users
            WHERE Type = 3 FOR XML RAW
	结果:
		<row Name="123" Pwd="123" Type="3" />
		<row Name=“www” Pwd=“www” Type=“3” />





三 使用sp_xml_preparedocument


语法

sp_xml_preparedocument
hdoc 
OUTPUT
[ , xmltext ]
[ , xpath_namespaces ] 

<script type="text/Javascript"> var ExpCollDivStr = ExpCollDivStr; ExpCollDivStr = ExpCollDivStr + "ctl00_LibFrame_ctl090966a28,"; var ExpCollImgStr = ExpCollImgStr; ExpCollImgStr = ExpCollImgStr + "ctl00_LibFrame_ctl09img,"; </script>
参数

hdoc

新创建文档的句柄。hdoc 是一个整数。

[ xmltext ]

是原来的 XML 文档。MSXML 分析器分析该 XML 文档。xmltext 是一个文本参数：char、nchar、varchar、nvarchar、text、ntext 或 xml。默认值为 NULL，在此情况下将创建一个空 XML 文档的内部表示形式。

注意：
sp_xml_preparedocument 只能处理文本或非类型化的 XML。如果将作为输入的实例值已经是类型化的 XML，首先将它转换为新的非类型化的 XML 实例，或者转换为一个字符串，然后传递该值作为输入。有关详细信息，请参阅类型化与非类型化的XML。

[ xpath_namespaces ]

指定在 OPENXML 的行和列 XPath 表达式中使用的命名空间声明。xpath_namespaces 是一个文本参数：char、nchar、varchar、nvarchar、text、ntext 或 xml。

默认值为 <root xmlns:mp="urn:schemas-microsoft-com:xml-metaprop">。xpath_namespaces 通过格式正确的 XML 文档为在 OPENXML 中的 XPath 表达式中使用的前缀提供命名空间 URI。xpath_namespaces 声明必须使用前缀来引用命名空间 urn:schemas-microsoft-com:xml-metaprop；这将提供有关分析的 XML 元素的元数据。虽然可以使用这项技术来为元属性命名空间重新定义命名空间前缀，但该命名空间不会丢失。即使 xpath_namespaces 不包含这类声明，前缀 mp 依然对 urn:schemas-microsoft-com:xml-metaprop 有效。

<script type="text/Javascript"> var ExpCollDivStr = ExpCollDivStr; ExpCollDivStr = ExpCollDivStr + "ctl00_LibFrame_ctl1119c4044,"; var ExpCollImgStr = ExpCollImgStr; ExpCollImgStr = ExpCollImgStr + "ctl00_LibFrame_ctl11img,";</script> 返回代码值

0（成功）或 >0（失败）

 

实例：
 
  
  
             
DECLARE @hDoc int
EXEC sp_xml_preparedocument @hDoc OUTPUT,@strXml
SELECT @Grade = GradeRes FROM OpenXml(@hDoc,'/Student/Count',1) WITH (GradeRes VARCHAR(30)) 



四 sp_xml_removedocument
	删除文档句柄指定的 XML 文档的内部表示方式并使该文档句柄无效。

语法

sp_xml_removedocument hdoc