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 : StringUne commande d'exécution spécifique à une source de données.
commandType
Type : Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandTypeLe 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 : Int32La 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.