DataCommand 類別

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

繼承階層架構

System.Object
  Microsoft.VisualStudio.Data.DataCommand

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

語法

'宣告
<GuidAttribute("E19F79F4-3219-423d-97A4-5A2B8A8F45F3")> _
Public MustInherit Class DataCommand

[GuidAttribute("E19F79F4-3219-423d-97A4-5A2B8A8F45F3")]
public abstract class DataCommand

[GuidAttribute(L"E19F79F4-3219-423d-97A4-5A2B8A8F45F3")]
public ref class DataCommand abstract

[<AbstractClass>]
[<GuidAttribute("E19F79F4-3219-423d-97A4-5A2B8A8F45F3")>]
type DataCommand =  class end

public abstract class DataCommand

DataCommand 型別會公開下列成員。

建構函式

	名稱	說明
	DataCommand	類別建構函式。具現化 DataCommand 類別的新執行個體。

回頁首

方法

	名稱	說明
	CreateParameter	建立可以傳遞至 DeriveSchema、 Execute 或 ExecuteWithoutResults方法在 DataCommand類別執行個體的參數物件。
	DeriveParameters	取得可為指定的命令中指定的參數。
	DeriveSchema	從指定的命令取得傳回的結構描述，表示項目和區塊的配置資料讀取器。
	Equals	判斷指定的物件是否等於目前物件。 (繼承自 Object)。
	Execute	執行指定的命令，並選擇性地使用參數並傳回唯讀的結果。
	ExecuteWithoutResults	執行命令，並選擇性地使用參數，則傳回，而不需要結果，而是傳回表示呼叫的結果整數。
	Finalize	允許物件在記憶體回收進行回收之前，嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。
	GetHashCode	做為特定型別的雜湊函式。 (繼承自 Object)。
	GetType	取得目前執行個體的 Type。 (繼承自 Object)。
	MemberwiseClone	建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
	Prepare	準備資料來源之指定的順序執行，這個命令可能會執行多次，以變更的參數。
	ToString	傳回表示目前物件的字串。 (繼承自 Object)。

回頁首

備註

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

DataCommand 類別引進命令類型的概念。命令類型指出某個命令字串中以程式設計方式解譯。例如，命令類型「Text」可能呼叫 DDEX 提供者命令字串可直接執行的 SQL 陳述式。另一方面， 「TabularFunction」命令類型可能呼叫 DDEX 提供者命令字串是應該執行使用適當的方法，資料表值函式的名稱。

基礎技術偏好 ODBC、OLE DB 和 ADO.NET 嘗試列舉一組允許值的命令類型，通常為純文字，以資料表形式，或為預存程序。DataCommand 類別將會放寬這類命令類型源自於固定列舉型別需要擴充這個概念。這麼做可讓 DDEX 提供者加入自訂命令類型提供相當大的彈性，包括說明如何及何時可以使用命令。

注意事項
若要提供命令執行功能，不過，以非同步方式，使用 DataAsyncCommand類別，會有一組方法相當於在這些 DataCommand 類別，但作業，請以非同步的方式。

從 DataCommand 類別衍生自類別的類別必須實作由其 DDEX 提供者實作不支援的方法。每個方法的基底實作會擲回 NotSupportedException。

執行緒安全

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

請參閱

參考

Microsoft.VisualStudio.Data 命名空間

DataCommandType