DataCommand, classe
Permet de générer et exécuter des commandes de données de différents types à des sources de données, et de récupérer des résultats en lecture seule ou un code d'état de commande.
Hiérarchie d'héritage
Object
Microsoft.VisualStudio.Data.DataCommand
Espace de noms : Microsoft.VisualStudio.Data
Assembly : Microsoft.VisualStudio.Data (dans Microsoft.VisualStudio.Data.dll)
Syntaxe
'Déclaration
<GuidAttribute("E19F79F4-3219-423d-97A4-5A2B8A8F45F3")> _
Public MustInherit Class DataCommand
[GuidAttribute("E19F79F4-3219-423d-97A4-5A2B8A8F45F3")]
public abstract class DataCommand
[GuidAttribute(L"E19F79F4-3219-423d-97A4-5A2B8A8F45F3")]
public ref class DataCommand abstract
[<AbstractClass>]
[<GuidAttribute("E19F79F4-3219-423d-97A4-5A2B8A8F45F3")>]
type DataCommand = class end
public abstract class DataCommand
Le type DataCommand expose les membres suivants.
Constructeurs
| Nom | Description | |
|---|---|---|
.gif "Méthode protégée") |
DataCommand | Constructeur de classe.Instancie une nouvelle instance de la classe DataCommand. |
Début
Méthodes
| Nom | Description | |
|---|---|---|
.gif "Méthode publique") |
CreateParameter | Crée un objet paramètre qui peut être passé dans l' DeriveSchema, l' Execute ou les méthodes d' ExecuteWithoutResultssur une instance de la classe d' DataCommand. |
|
DeriveParameters | Dérive les paramètres qui peuvent être spécifiés pour une commande donnée. |
|
DeriveSchema | Dérive le schéma retourné d'une commande spécifiée, indiquant la disposition des éléments et des blocs dans un lecteur de données. |
|
Equals | Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.) |
|
Execute | Exécute une commande spécifiée, éventuellement avec des paramètres, et les résultats en lecture seule de retour. |
|
ExecuteWithoutResults | Exécute une commande, éventuellement avec des paramètres, mais ne demande pas de résultats, à la place retourne un entier indiquant les résultats de l'appel. |
|
Finalize | Autorise un objet à tenter de libérer des ressources et à exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par une opération garbage collection. (Hérité de Object.) |
|
GetHashCode | Sert de fonction de hachage par défaut. (Hérité de Object.) |
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
MemberwiseClone | Crée une copie superficielle du Object actuel. (Hérité de Object.) |
|
Prepare | 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. |
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
Début
Notes
Les fournisseurs de DDEX peuvent exécuter différents types de commandes par rapport à la source de données. Cela ne peut inclure, mais être limité à, des instructions SQL, des procédures, des appels de fonction. Ils peuvent également exposer la capacité de préparer et dériver des paramètres et des schémas pour les commandes.
La classe d' DataCommand introduit le concept d'un type de commande. Un type de commande indique une traduction de programmation d'une chaîne d'ordres donnée. Par exemple, un type « texte » de commande peut indiquer au fournisseur de DDEX que la chaîne d'ordres est une instruction SQL qui doit être exécutée directement. En revanche, un type de commande « TabularFunction » peut indiquer au fournisseur de DDEX que la chaîne d'ordres est le nom d'une fonction table qui doit être effectuée à l'aide de la méthode appropriée.
Les technologies sous-jacentes comme ODBC, OLE DB, et la tentative d' ADO.NET d'énumérer un ensemble de types autorisés de commande, généralement en texte brut, sous la forme de tableau, ou comme des procédures stockées. La classe d' DataCommand étend ce concept en détendant la spécification qu'un tel type de contrôle proviennent d'une énumération fixe. Cela fournit un énorme souplesse en permettant aux fournisseurs de DDEX pour ajouter des types personnalisés de commande, y compris les descriptions de comment et quand les commandes peuvent être utilisées.
Notes
Pour permettre d'exécution de la commande, mais de façon asynchrone, utilisez la classe d' DataAsyncCommand, qui a un jeu de méthodes équivalentes à ceux de la classe d' DataCommand , mais qui fonctionnent de façon asynchrone.
Les classes dérivées de la classe d' DataCommand doivent appliquer ces méthodes prises en charge par leur implémentation de fournisseur de DDEX. L'implémentation de base de chaque méthode lève simplement NotSupportedException.
Sécurité des threads
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.