Partager via


DataCommand.Prepare, méthode (String, DataCommandType, array<IVsDataParameter[], Int32)

Prépare la commande spécifiée dans la source de données à exécuter ; la commande peut ensuite s'exécuter plusieurs fois, dans des paramètres.

Espace de noms :  Microsoft.VisualStudio.Data.Framework
Assembly :  Microsoft.VisualStudio.Data.Framework (dans Microsoft.VisualStudio.Data.Framework.dll)

Syntaxe

'Déclaration
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

Paramètres

  • command
    Type : String

    Une commande d'exécution spécifique à une source de données.

  • commandTimeout
    Type : Int32

    La durée, en secondes, pour bloquer le client avant d'annuler l'exécution et retourner à l'appelant. La valeur 0 indique le délai d'attente infini ; une valeur de -1 indique une valeur par défaut du fournisseur.

Valeur de retour

Type : String
Identificateur de la commande préparée qui peut ensuite être passée à la méthode de Execute ou d'ExecuteWithoutResults à l'aide du type Prepared de commande.

Implémentations

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

Exceptions

Exception Condition
ArgumentNullException

Le paramètre command est nullune référence null (Nothing en Visual Basic).

ArgumentOutOfRangeException

Le paramètre commandTimeout est inférieur à -1.

Notes

D'autres exceptions qui se produisent indiquent que la préparation a échoué pour une raison fournisseur- spécifiée.

Sécurité .NET Framework

Voir aussi

Référence

DataCommand Classe

Prepare, surcharge

Microsoft.VisualStudio.Data.Framework, espace de noms

DataCommand