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

發行項
05/16/2015

準備資料來源中指定的順序執行;命令可以執行多次，以變更的參數。

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

語法

'宣告
Public Overridable Function Prepare ( _
    command As String, _
    commandType As DataCommandType, _
    parameters As IVsDataParameter(), _
    commandTimeout As Integer _
) As String

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

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

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

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

參數

command
類型：String

要針對資料來源執行的命令。

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

指定如何解譯 command 參數的內容命令的型別。命令型別可能是來自 DataCommandType 列舉的值或提供者所定義的自訂命令類型，可以強制從整數的轉型傳遞至 DataCommandType 列舉。

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

陣列代表指定的命令類型之 IVsDataParameter 物件命令參數。

commandTimeout
類型：Int32

時間，以秒為單位)，在取消執行和傳回之前封鎖用戶端傳遞給呼叫端。 0 表示無限逾時的值;值為 -1 表示預設提供者。

傳回值

類型：String
使用命令型別 Prepared，稍後可傳遞給 Execute 或 ExecuteWithoutResults 方法備製命令的識別項。

實作

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

例外狀況

例外狀況	條件
ArgumentNullException	command 參數為 nullnull 參考 (即 Visual Basic 中的 Nothing)。
ArgumentOutOfRangeException	commandTimeout 參數小於 -1。