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

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 Function Prepare ( _
    command As String, _
    commandType As DataCommandType, _
    parameters As IVsDataParameter() _
) As String

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

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

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

public final function Prepare(
    command : String, 
    commandType : DataCommandType, 
    parameters : IVsDataParameter[]
) : 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.

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[])

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.