• 發行項

SqlXmlCommand 物件 (SQLXML Managed 類別)

這是 SqlXmlCommand 物件的建構函式：

public SqlXmlCommand(string cnString)

其中 cnString 是識別伺服器、資料庫以及登入資訊的 ADO 或 OLEDB 連接字串，例如，Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI"。

在連接字串中，Provider 必須為 SQLOLEDB 而 Data Provider 不應包含在連接字串中。

如需實用範例，請參閱＜執行 SQL 查詢 (SQLXML Managed 類別)＞。

方法

SqlXmlCommand 物件支援數種方法，包括下列執行命令的方法：

  • void ExecuteNonQuery()
    執行命令，但不會傳回任何東西。如果您要執行非查詢命令 (也就是不會傳回任何東西的命令)，此方法相當實用。例如，執行更新記錄但不會傳回任何東西的 Updategram 或 DiffGram。

  • Stream ExecuteStream()
    傳回新的 Stream 物件。當您希望讓新資料流中的查詢結果傳回給您時，此方法相當實用。如需實用範例，請參閱＜執行 SQL 查詢 (SQLXML Managed 類別)＞。

  • public void ExecuteToStream(Stream outputStream)
    將查詢結果寫入現有的資料流。當您擁有需要在其中附加結果的資料流時，此方法相當實用 (例如，讓查詢結果寫入 System.Web.HttpResponse.OutputStream)。如需實用範例，請參閱＜執行 SQL 查詢 (SQLXML Managed 類別)＞。

  • XmlReader ExecuteXmlReader()
    傳回 XmlReader 物件。您可以使用此方法直接操作 XmlReader 物件中的資料，或插入 System.Xml 的可鏈結架構。如需詳細資訊，請參閱 Microsoft .NET Framework 文件集。如需實用範例，請參閱＜使用 ExecuteXMLReader 方法執行 SQL 查詢＞。

SqlXmlCommand 物件也支援這些額外的方法：

  • SqlXmlParameter CreateParameter()
    建立 SqlXmlParameter 物件。您可以設定 Name 的值以及此物件的 Value 參數。如果您要將參數傳遞到命令，這個方法相當實用。如需實用範例，請參閱＜執行 SQL 查詢 (SQLXML Managed 類別)＞。

  • 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 Managed 類別)＞。

  • Base Path
    基底路徑 (目錄路徑)。此屬性 (Property) 對於解析針對 XSL 檔 (透過使用 XslPath 屬性 (Property))、對應結構描述檔 (透過使用 SchemaPath 屬性 (Property))，或 XML 範本中的外部結構描述參考 (透過使用 mapping-schema 屬性 (Attribute) 指定) 指定的相對路徑相當實用。

  • OutputEncoding
    指定命令執行時所傳回之資料流的編碼。此屬性對於要求所傳回之資料流的特定編碼相當實用。一些常用的編碼為 UTF-8、ANSI 和 Unicode。UTF-8 是預設編碼。

  • Namespaces
    允許使用命名空間的 XPath 查詢得以執行。如需有關包含命名空間之 XPath 查詢的詳細資訊，請參閱＜執行含有命名空間的 XPath 查詢 (SQLXML Managed 類別)＞。如需實用範例，請參閱＜執行 XPath 查詢 (SQLXML Managed 類別)＞。

  • RootTag
    提供命令執行所產生之 XML 的單一根元素。有效的 XML 文件需要單一根層級標籤。如果執行的命令產生 XML 片段 (沒有單一最上層元素)，您可以指定傳回之 XML 的根元素。如需實用範例，請參閱＜套用 XSL 轉換 (SQLXML Managed 類別)＞。

  • CommandText
    命令的文字。此屬性對於指定您要執行之命令的文字相當實用。如需實用範例，請參閱＜執行 SQL 查詢 (SQLXML Managed 類別)＞。

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