DataCommand.Execute, méthode

Article
11/15/2012

Exécute une commande spécifiée, éventuellement avec des paramètres, et les résultats en lecture seule de retour.

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

Syntaxe

'Déclaration
Public Overridable Function Execute ( _
    command As String, _
    commandType As Integer, _
    parameters As DataParameter(), _
    commandTimeout As Integer _
) As DataReader

public virtual DataReader Execute(
    string command,
    int commandType,
    DataParameter[] parameters,
    int commandTimeout
)

public:
virtual DataReader^ Execute(
    String^ command, 
    int commandType, 
    array<DataParameter^>^ parameters, 
    int commandTimeout
)

abstract Execute : 
        command:string * 
        commandType:int * 
        parameters:DataParameter[] * 
        commandTimeout:int -> DataReader 
override Execute : 
        command:string * 
        commandType:int * 
        parameters:DataParameter[] * 
        commandTimeout:int -> DataReader

public function Execute(
    command : String, 
    commandType : int, 
    parameters : DataParameter[], 
    commandTimeout : int
) : DataReader

Paramètres

command
Type : System.String
Une commande d'exécution spécifique à une source de données.

commandType
Type : System.Int32
Le type de commande pour l'ordre indiqué, spécifiant comment interpréter le contenu du paramètre d' command .

parameters
Type : array<Microsoft.VisualStudio.Data.DataParameter[]
Un tableau d'objets DataParameter pour le type spécifié de commande.Lorsque c'est un paramètre d'entrée, le fournisseur de DDEX peut encore définir des propriétés sur la personne et les paramètres de valeur de retour.

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 le délai d'attente infini ; une valeur de -1 indique une valeur par défaut de fournisseur.

Valeur de retour

Type : Microsoft.VisualStudio.Data.DataReader
Retourne un objet d' DataReader , qui fournit un flux avant uniquement en lecture seule de la source de données.

Exceptions

Exception	Condition
ArgumentNullException	La commande ou les asyncCommandEvents sont null.
ArgumentException	Le commandType spécifie un type non valide.
ArgumentOutOfRangeException	Le commandTimeout est inférieure à -1.
NotSupportedException	Le fournisseur ne prend pas en charge cette méthode.

Notes

En raison de varier les commandes dans lesquelles les valeurs de données et de paramètre peuvent être retournées par une source de données, ou les paramètres de valeur de retour spécifié dans le tableau d' parameters d'objets d' DataParameter peuvent être récupérés uniquement après DataReader retourné a été fermé.

[!REMARQUE]

D'autres exceptions qui se produisent indiquent que la dérivation de paramètre 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.