DataCommand.Prepare 方法 (String, DataCommandType, array<IVsDataParameter[])

2015-05-17

准备在数据源中的指定命令；执行命令会执行多次，具有不同的参数。

命名空间： Microsoft.VisualStudio.Data.Framework
程序集： Microsoft.VisualStudio.Data.Framework（在 Microsoft.VisualStudio.Data.Framework.dll 中）

语法

声明
Public Function Prepare ( _
    command As String, _
    commandType As DataCommandType, _
    parameters As IVsDataParameter() _
) As String

public string Prepare(
    string command,
    DataCommandType commandType,
    IVsDataParameter[] parameters
)

public:
virtual String^ Prepare(
    String^ command, 
    DataCommandType commandType, 
    array<IVsDataParameter^>^ parameters
) sealed

abstract Prepare : 
        command:string * 
        commandType:DataCommandType * 
        parameters:IVsDataParameter[] -> string  
override Prepare : 
        command:string * 
        commandType:DataCommandType * 
        parameters:IVsDataParameter[] -> string

public final function Prepare(
    command : String, 
    commandType : DataCommandType, 
    parameters : IVsDataParameter[]
) : String

参数

command
类型：String

特定于数据源的命令执行。

commandType
类型：Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType

解释如何指定 command 参数的命令内容的类型。命令类型可以是 DataCommandType 枚举中的一个值或提供程序定义的自定义命令类型，可以通过强制从整数的一个转换将为 DataCommandType 枚举。

parameters
类型：array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]

一个表示指定命令的 IVsDataParameter 指令对象参数类型。

返回值

类型：String
使用命令类型 Prepared，稍后传递给 Execute 或 ExecuteWithoutResults 方法可以命令的标识符。

实现

IVsDataCommand.Prepare(String, DataCommandType, array<IVsDataParameter[])

异常

异常	条件
ArgumentNullException	command 参数为 nullnull 引用（在 Visual Basic 中为 Nothing）。
ArgumentOutOfRangeException	commandTimeout 参数小于 -1。