SQLXML 受控類別 - SqlXmlCommand 物件

適用於：SQL ServerAzure SQL 資料庫

這是 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 查詢的對應架構。 指定的路徑可以是絕對或相對路徑。 如果路徑是相對路徑，則會使用基底路徑中指定的基底路徑來解析相對路徑。 如果未指定基底路徑，則相對路徑會相對於目前目錄。 如需運作中的範例，請參閱 存取 .NET 環境中的 SQLXML 功能。

XslPath
XSL 檔案的名稱以及目錄路徑。 指定的路徑可以是絕對或相對路徑。 如果路徑是相對路徑，則會使用基底路徑中指定的基底路徑來解析相對路徑。 如果未指定基底路徑，則相對路徑會相對於目前目錄。 如需有效的範例，請參閱套用 XSL 轉換（SQLXML Managed 類別）。

基底路徑
基底路徑（目錄路徑）。 這個屬性適用於解析針對 XSL 檔案指定的相對路徑（使用 XslPath 屬性）、對應架構檔案（使用 SchemaPath 屬性），或 XML 範本中的外部架構參考（使用 對應架構 屬性所指定）。

OutputEncoding
指定命令執行時所傳回數據流的編碼方式。 這個屬性適用於要求傳回之數據流的特定編碼方式。 一些常用的編碼方式是UTF-8、ANSI和Unicode。 UTF-8 是預設編碼方式。

命名空間
啟用使用命名空間的 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 功能。

另請參閱

SqlXmlParameter 物件 （SQLXML Managed 類別）
SqlXmlAdapter 物件 （SQLXML Managed 類別）