通过

DataCommand 类

可以生成并执行各种类型的数据命令数据源和检索只读结果或命令状态代码。

继承层次结构

System.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 的浅表副本。 （继承自 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>。）

页首

备注

数据设计器扩展性(DDEX)提供程序可以执行命令各种类型的数据源。这可能包括，但是，在绑定到，SQL语句，程序，并且，函数调用。还可以显示该功能和派生参数和模式为命令准备。

DataCommand 选件类引入命令类型。命令类型指示特定命令字符串的编程说明。例如，命令类型文本可能会通知DDEX提供程序命令字符串是应直接执行SQL语句。或者，TabularFunction命令类型可能会通知DDEX提供程序命令字符串是应通过使用适当的方法，一个表赋值的函数的名称。

基础技术(如开放式数据库连接(odbc)，OLE DB和 ADO.NET 尝试枚举作为存储过程设置允许的命令类型，通常为纯文本，表格形式，或。DataCommand 选件类通过放宽此类命令类型则源自内置的枚举的要求扩展此概念。这使DDEX提供程序与说明如何以及何时一起添加自定义命令类型提供灵活性，可以使用命令。

说明说明

若要提供命令执行异步功能，请使用 DataAsyncCommand 选件类。此选件类具有与等效在 DataCommand 选件类的方法，但是，这些方法进行异步操作。

对继承者的说明

当从 DataCommand 选件类继承时，必须重写从将由其DDEX提供程序实现支持的此选件类的每个方法。每个方法的基实现此选件类中引发 NotSupportedException。

请注意 ExecuteWithoutResults 方法具有委托给 Execute 方法的基实现。

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

请参见

参考

Microsoft.VisualStudio.Data.Framework 命名空间

DataCommandType