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

Article
05/16/2015

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.

commandType
Type : Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType

Le type de commande qui spécifie comment interpréter le contenu du paramètre command. Type de commande peut être une valeur de l'énumération d'un DataCommandType ou un type personnalisé de commande défini par un fournisseur, qui peut être passé en imposant un cast d'un entier à l'énumération d'DataCommandType.

parameters
Type : array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]

Tableau d'objets IVsDataParameter représentant les paramètres de commande pour le type spécifié de commande.

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

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, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.