SqlXmlCommand 对象 （SQLXML 托管类）

这是 SqlXmlCommand 对象的构造函数：

public SqlXmlCommand(string cnString)  

其中 cnString ，用于标识服务器、数据库和登录信息的 ADO 或 OLEDB 连接字符串， Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI"例如。

在连接字符串中， Provider 必须是 SQLOLEDB， Data Provider 并且不应包含在提供程序字符串中。

有关工作示例，请参阅执行 SQL 查询（SQLXML 托管类）。

方法

TheSqlXmlCommand 对象支持多种方法，包括执行命令的以下方法：

void ExecuteNonQuery（）
执行命令，但不返回任何内容。 如果要执行非查询命令（即不返回任何命令的命令），此方法非常有用。 例如，执行 updategram 或 DiffGram 来更新记录，但不返回任何内容。

Stream ExecuteStream（）
返回新的 Stream 对象。 当希望在新流中返回查询结果时，此方法非常有用。 有关工作示例，请参阅执行 SQL 查询（SQLXML 托管类）。

public void ExecuteToStream（Stream outputStream）
将查询结果写入现有流。 当有需要追加结果的流（例如，将查询结果写入 System.Web.HttpResponse.OutputStream）时，此方法非常有用。 有关工作示例，请参阅执行 SQL 查询（SQLXML 托管类）。

XmlReader ExecuteXmlReader（）
返回 XmlReader 对象。 可以使用此方法直接作 XmlReader 对象中的数据，或插入 System.Xml 的可链接体系结构。 有关详细信息，请参阅 Microsoft .NET Framework 文档。 有关工作示例，请参阅 使用 ExecuteXMLReader 方法执行 SQL 查询。

TheSqlXmlCommand 对象还支持以下其他方法：

SqlXmlParameter CreateParameter（）
创建 SqlXmlParameter 对象。 可以为此对象的 Name 和 Value 参数设置值。 如果要将参数传递给命令，此方法非常有用。 有关工作示例，请参阅执行 SQL 查询（SQLXML 托管类）。

void ClearParameters（）
清除为给定命令对象创建的参数（s）。 如果要对同一命令对象执行多个查询，此方法非常有用。

性能

SqlXmlCommand 对象还支持以下属性：

ClientSideXml
设置为 True 时，指定行集到 XML 的转换发生在客户端而不是服务器上。 如果要将性能负载移动到中间层，此属性非常有用。 该属性还允许使用 FOR XML 包装现有存储过程以获取 XML 输出。

SchemaPath
映射架构的名称以及目录路径（例如，C:\x\y\MySchema.xml）。 此属性可用于指定 XPath 查询的映射架构。 指定的路径可以是绝对路径或相对路径。 如果路径是相对路径，则基路径中指定的基路径用于解析相对路径。 如果未指定基路径，则相对路径相对于当前目录。 有关工作示例，请参阅 访问 .NET 环境中的 SQLXML 功能。

XslPath
XSL 文件的名称以及目录路径。 指定的路径可以是绝对路径或相对路径。 如果路径是相对路径，则基路径中指定的基路径用于解析相对路径。 如果未指定基路径，则相对路径相对于当前目录。 有关工作示例，请参阅应用 XSL 转换（SQLXML 托管类）。

基本路径
基路径（目录路径）。 此属性可用于解析为 XSL 文件指定的相对路径（通过使用 XslPath 属性）、映射架构文件（通过使用 SchemaPath 属性）或 XML 模板中的外部架构引用（使用 mapping-schema 特性指定）。

OutputEncoding
指定命令执行时返回的流的编码。 此属性可用于请求返回的流的特定编码。 一些常用的编码是 UTF-8、ANSI 和 Unicode。 UTF-8 是默认编码。

命名空间
启用使用命名空间的 XPath 查询的执行。 有关具有命名空间的 XPath 查询的详细信息，请参阅使用命名空间执行 XPath 查询（SQLXML 托管类）。 有关工作示例，请参阅执行 XPath 查询（SQLXML 托管类）。

RootTag
为命令执行生成的 XML 提供单个根元素。 有效的 XML 文档需要单个根级标记。 如果执行的命令生成 XML 片段（没有单个顶级元素），则可以为返回的 XML 指定根元素。 有关工作示例，请参阅应用 XSL 转换（SQLXML 托管类）。

CommandText
命令的文本。 此属性用于指定要执行的命令的文本。 有关工作示例，请参阅执行 SQL 查询（SQLXML 托管类）。

CommandStream
命令流。 如果要从文件（例如 XML 模板）执行命令，此属性非常有用。 使用 CommandStream 时，仅支持“Template”、“UpdateGram”和“DiffGram”CommandType 值。 有关工作示例，请参阅 使用 CommandStream 属性执行模板文件。

命令类型
标识命令的类型。 此属性用于指定要执行的命令类型。 下表中的值确定命令的类型。 有关工作示例，请参阅 访问 .NET 环境中的 SQLXML 功能。

另请参阅

SqlXmlParameter 对象 （SQLXML 托管类）
SqlXmlAdapter 对象 （SQLXML 托管类）