共用方式為


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。

請參閱

參考

SqlXmlParameter 物件 (SQLXML Managed 類別)

SqlXmlAdapter 物件 (SQLXML Managed 類別)