DataCommand 類別

提供建立和執行各種型別的資料命令物件資料來源並擷取唯讀結果或命令狀態碼。

繼承階層架構

Object
  Microsoft.VisualStudio.Data.Framework.DataSiteableObject<IVsDataConnection>
    Microsoft.VisualStudio.Data.Framework.DataCommand

命名空間：  Microsoft.VisualStudio.Data.Framework
組件：  Microsoft.VisualStudio.Data.Framework (在 Microsoft.VisualStudio.Data.Framework.dll 中)

語法

'宣告
Public MustInherit Class DataCommand _
    Inherits DataSiteableObject(Of IVsDataConnection) _
    Implements IVsDataCommand

public abstract class DataCommand : DataSiteableObject<IVsDataConnection>, 
    IVsDataCommand

public ref class DataCommand abstract : public DataSiteableObject<IVsDataConnection^>, 
    IVsDataCommand

[<AbstractClass>]
type DataCommand =  
    class 
        inherit DataSiteableObject<IVsDataConnection>
        interface IVsDataCommand 
    end

public abstract class DataCommand extends DataSiteableObject<IVsDataConnection> implements IVsDataCommand

DataCommand 類型會公開下列成員。

建構函式

	名稱	描述
	DataCommand()	初始化 DataCommand 類別的新執行個體。
	DataCommand(IVsDataConnection)	與資料連接物件來初始化 DataCommand 類別的新執行個體。

回頁首

屬性

	名稱	描述
	Site	取得或設定物件的網站。 (繼承自 DataSiteableObject<T>)。

回頁首

方法

	名稱	描述
	CreateParameter	建立可以傳遞至 DeriveSchema、 DeriveSchema、 Execute或 ExecuteWithoutResults 方法將 DataCommand 執行個體的參數物件。
	DeriveParameters(String)	取得可以針對指定的命令中指定的參數。
	DeriveParameters(String, DataCommandType)	取得可以針對指定的命令中指定的參數。
	DeriveParameters(String, DataCommandType, Int32)	取得可以針對指定的命令中指定的參數。
	DeriveSchema(String)	從指定的命令取得結構描述中傳回。結構描述表示項目和區塊配置資料讀取器。
	DeriveSchema(String, DataCommandType)	從指定的命令取得結構描述中傳回。結構描述表示項目和區塊配置資料讀取器。
	DeriveSchema(String, DataCommandType, array<IVsDataParameter[])	從指定的命令取得結構描述中傳回。結構描述表示項目和區塊配置資料讀取器。
	DeriveSchema(String, DataCommandType, array<IVsDataParameter[], Int32)	從指定的命令取得結構描述中傳回。結構描述表示項目和區塊配置資料讀取器。
	Equals	判斷指定的物件是否等於目前的物件。 (繼承自 Object)。
	Execute(String)	執行指定的命令並傳回唯讀結果。
	Execute(String, DataCommandType)	執行指定的命令並傳回唯讀結果。
	Execute(String, DataCommandType, array<IVsDataParameter[])	執行指定的命令，並選擇性地使用參數且會傳回唯讀結果。
	Execute(String, DataCommandType, array<IVsDataParameter[], Int32)	執行指定的命令，並選擇性地使用參數且會傳回唯讀結果。
	ExecuteWithoutResults(String)	執行命令，但未要求結果，反而會傳回呼叫的結果整數。
	ExecuteWithoutResults(String, DataCommandType)	執行命令，但未要求結果，反而會傳回呼叫的結果整數。
	ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[])	執行命令，並選擇性地使用參數，但是，要求結果，反而會傳回呼叫的結果整數。
	ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[], Int32)	執行命令，並選擇性地使用參數，但是，要求結果，反而會傳回呼叫的結果整數。
	Finalize	在記憶體回收開始前，允許物件嘗試釋放資源，並執行其他清除作業。 (繼承自 Object)。
	GetHashCode	做為預設雜湊函式。 (繼承自 Object)。
	GetType	取得目前實例 Type 的屬性。 (繼承自 Object)。
	MemberwiseClone	建立目前 Object 的淺層複製 (Shallow Copy) 。 (繼承自 Object)。
	OnSiteChanged	引發 SiteChanged 事件。 (繼承自 DataSiteableObject<T>)。
	Prepare(String)	準備資料來源中指定的順序執行;命令可以執行多次，以變更的參數。
	Prepare(String, DataCommandType)	準備資料來源中指定的順序執行;命令可以執行多次，以變更的參數。
	Prepare(String, DataCommandType, array<IVsDataParameter[])	準備資料來源中指定的順序執行;命令可以執行多次，以變更的參數。
	Prepare(String, DataCommandType, array<IVsDataParameter[], Int32)	準備資料來源中指定的順序執行;命令可以執行多次，以變更的參數。
	ToString	傳回代表目前物件的字串。 (繼承自 Object)。

回頁首

事件

	名稱	描述
	SiteChanged	在 Site 屬性變更時發生。 (繼承自 DataSiteableObject<T>)。

回頁首

備註

資料設計工具 Extensibility (DDEX) 提供者可以執行命令的各種型別的物件資料來源。 這可能不包含，，但只限於， SQL 陳述式、程序及函式呼叫。 它們可能也會公開能力和衍生參數和結構描述為命令準備。

DataCommand 類別中所引入命令類型。 命令型別表示特定命令字串的程式設計說明。 例如，命令型別文字可能會通知 DDEX 提供者命令字串是應該直接執行的 SQL 陳述式。 或者， TabularFunction 命令類型可能會通知 DDEX 提供者命令字串是應該執行使用適當的方法，資料表值函式的名稱。

基礎技術 (例如開放式資料庫連接 (Open Database Connectivity，ODBC)， OLE DB 和 ADO.NET 嘗試列舉一組允許命令型別，通常為純文字，以資料表形式出現，或是以預存程序。 DataCommand 類別是透過將寬這類命令型別來自 Pin 列舉的需要擴充這個概念。 這可以讓 DDEX 提供者與描述如何及何時將自訂命令類型提供彈性，才能使用命令。

注意事項
若要提供命令執行非同步功能，請使用 DataAsyncCommand 類別。這個類別具有與 DataCommand 中包含的類別的一組方法，不過，這些方法會以非同步方式。

繼承者注意事項

當您從 DataCommand 類別繼承時，必須覆寫從要由其 DDEX 提供者實作支援之類別的每個方法。 每個方法的基底實作這個類別會擲回 NotSupportedException。

請注意 ExecuteWithoutResults 方法有一個基底實作委派給 Execute 方法。

執行緒安全

這個類型的任何 Public static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。不保證任何執行個體成員是安全執行緒。

請參閱

參考

Microsoft.VisualStudio.Data.Framework 命名空間

DataCommandType