通过

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