DataCommand.Prepare – metoda (String, DataCommandType, array<IVsDataParameter , Int32)

Článek
10/27/2012

Připraví zadaný příkaz na zdroji dat mají být provedeny; příkaz může být spuštěn vícekrát s různými parametry.

Obor názvů: Microsoft.VisualStudio.Data.Framework
Sestavení: Microsoft.VisualStudio.Data.Framework (v Microsoft.VisualStudio.Data.Framework.dll)

Syntaxe

'Deklarace
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

Parametry

command
Typ: System.String
Příkaz ke spuštění konkrétního zdroje dat.

commandType
Typ: Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType
Typ příkazu, který určuje, jak interpretovat obsah command parametr.Typ příkazu může buď hodnota z DataCommandType výčtu nebo typ vlastní příkaz definované pomocí zprostředkovatele lze předat vynucením nádech z celé DataCommandType výčtu.

parameters
Typ: array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]
Pole IVsDataParameter objekty představující typ zadaný příkaz parametry příkazu.

commandTimeout
Typ: System.Int32
Délka čas v sekundách blokovat klienta před provedení zrušení a vrácení volajícímu.Hodnota 0 znamená neomezený časový limit; Hodnota -1 označuje výchozí zprostředkovatel.

Vrácená hodnota

Typ: System.String
Identifikátor připravený příkaz, který lze později předat Execute nebo ExecuteWithoutResults metoda pomocí příkazu typu Prepared.

Implementuje

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

Výjimky

Výjimka	Podmínka
ArgumentNullException	The command parameter is nullodkaz null (Nothing v jazyce Visual Basic).
ArgumentOutOfRangeException	commandTimeout Je menší než parametr.

Poznámky

Další výjimky, které nastat označují, že přípravy se nezdařilo z důvodu zadat zprostředkovatele.

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.