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

Article
11/15/2012

Prépare la commande spécifiée dans la source de données à exécuter ; la commande peut ensuite être exécuté plusieurs fois, avec diverses 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 : System.String
Une commande d'exécution spécifique à une source de données.

commandType
Type : Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType
Le type de la commande qui spécifie comment interpréter le contenu du paramètre d' command .Le type de commande peut être une valeur de l'énumération d' DataCommandType ou un type personnalisé de commande défini par un fournisseur, qui peut être passé en forçant un cast d'un entier à l'énumération d' DataCommandType .

parameters
Type : array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]
Un tableau d' IVsDataParameter objets représentant les paramètres de commande pour le type spécifié de commande.

commandTimeout
Type : System.Int32
La durée, en secondes, pour bloquer le client avant d'annuler l'opération et retourner à l'appelant.Une valeur de 0 indique que la minuterie infinie ; une valeur de -1 indique une valeur par défaut de fournisseur.

Valeur de retour

Type : System.String
Un identificateur de la commande préparée qui peut ensuite être passée à l' Execute ou à la méthode d' ExecuteWithoutResults à l'aide de le type Preparedde 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

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.