• 项目

SqlXmlCommand 对象（SQLXML 托管类）

这是针对 SqlXmlCommand 对象的构造函数：

public SqlXmlCommand(string cnString)

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

在该连接字符串中，Provider 必须是 SQLOLEDB，并且 Data Provider 不应包括在访问接口字符串中。

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

方法

SqlXmlCommand 对象支持若干方法，包括用于执行某一命令的以下方法：

  • 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 查询。

SqlXmlCommand 对象还支持以下附加方法：

  • SqlXmlParameter CreateParameter()
    创建一个 SqlXmlParameter 对象。您可以为此对象的 Name 和 Value 参数设置值。如果您希望将参数传递到某一命令，则此方法很有用。有关工作示例，请参阅执行 SQL 查询（SQLXML 托管类）。

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

属性

SqlXmlCommand 对象还支持以下属性：

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

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

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

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

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

  • Namespaces
    允许执行使用命名空间的 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[@BusinessEntityID=1]）。

    SqlXmlCommandType.Template

    执行某一 XML 模板。

    SqlXmlCommandType.TemplateFile

    执行指定路径上的模板文件。

    SqlXmlCommandType.UpdateGram

    执行 updategram。

    SqlXmlCommandType.Diffgram

    执行 DiffGram。