SQLXML 托管类 - SqlXmlCommand 对象

适用于:SQL Server Azure SQL 数据库

这是 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 对象。 可以为此对象的 NameValue 参数设置值。 如果您希望将参数传递到某一命令,则此方法很有用。 有关工作示例,请参阅执行 SQL 查询(SQLXML 托管类)。

void ClearParameters()
清除为给定命令对象创建的参数。 如果您想要对同一命令对象执行多个查询,则此方法很有用。

属性

SqlXmlCommand 对象还支持以下属性:

ClientSideXml
在设置为 True 时,指定要在客户端上发生行集到 XML 的转换,而非在服务器上发生。 在希望将性能负荷移到中间层时,此属性很有用。 该属性还允许您使用 FOR XML 包装现有存储过程,以便获取 XML 输出。

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

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

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

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 属性执行模板文件。

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

说明
SqlXmlCommandType.Sql 执行某一 SQL 命令(例如 SELECT * FROM Employees FOR XML AUTO)。
SqlXmlCommandType.XPath 执行某一 XPath 命令(例如 Employees[@EmployeeID=1])。
SqlXmlCommandType.Template 执行某一 XML 模板。
SqlXmlCommandType.TemplateFile 执行指定路径上的模板文件。
SqlXmlCommandType.UpdateGram 执行 updategram。
SqlXmlCommandType.Diffgram 执行 DiffGram。

另请参阅

SqlXmlParameter 对象(SQLXML 托管类)
SqlXmlAdapter 对象(SQLXML 托管类)