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
System.Object
Microsoft.VisualStudio.Data.Framework.DataSiteableObject<IVsDataConnection>
Microsoft.VisualStudio.Data.Framework.DataCommand
Espace de noms : Microsoft.VisualStudio.Data.Framework
Assembly : Microsoft.VisualStudio.Data.Framework (dans Microsoft.VisualStudio.Data.Framework.dll)
Syntaxe
'Déclaration
Public MustInherit Class DataCommand _
Inherits DataSiteableObject(Of IVsDataConnection) _
Implements IVsDataCommand
public abstract class DataCommand : DataSiteableObject<IVsDataConnection>,
IVsDataCommand
public ref class DataCommand abstract : public DataSiteableObject<IVsDataConnection^>,
IVsDataCommand
[<AbstractClass>]
type DataCommand =
class
inherit DataSiteableObject<IVsDataConnection>
interface IVsDataCommand
end
public abstract class DataCommand extends DataSiteableObject<IVsDataConnection> implements IVsDataCommand
Le type DataCommand expose les membres suivants.
Constructeurs
| Nom | Description | |
|---|---|---|
.gif "Méthode protégée") |
DataCommand() | Initialise une nouvelle instance de la classe DataCommand. |
|
DataCommand(IVsDataConnection) | Initialise une nouvelle instance de la classe d' DataCommand avec un objet de connexion de données. |
Début
Propriétés
| Nom | Description | |
|---|---|---|
.gif "Propriété publique") |
Site | Obtient ou définit le site d'objet. (Hérité de DataSiteableObject<T>.) |
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' DeriveSchema, l' Execute, ou les méthodes d' ExecuteWithoutResults sur une instance de DataCommand . |
|
DeriveParameters(String) | Dérive les paramètres qui peuvent être spécifiés pour une commande donnée. |
|
DeriveParameters(String, DataCommandType) | Dérive les paramètres qui peuvent être spécifiés pour une commande donnée. |
|
DeriveParameters(String, DataCommandType, Int32) | Dérive les paramètres qui peuvent être spécifiés pour une commande donnée. |
|
DeriveSchema(String) | Dérive le schéma retourné d'une commande spécifiée.Le schéma indique la disposition des éléments et des blocs dans un lecteur de données. |
|
DeriveSchema(String, DataCommandType) | Dérive le schéma retourné d'une commande spécifiée.Le schéma indique la disposition des éléments et des blocs dans un lecteur de données. |
|
DeriveSchema(String, DataCommandType, array<IVsDataParameter[]) | Dérive le schéma retourné d'une commande spécifiée.Le schéma indique la disposition des éléments et des blocs dans un lecteur de données. |
|
DeriveSchema(String, DataCommandType, array<IVsDataParameter[], Int32) | Dérive le schéma retourné d'une commande spécifiée.Le schéma indique 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(String) | Exécute une commande spécifiée et retourne des résultats en lecture seule. |
|
Execute(String, DataCommandType) | Exécute une commande spécifiée et retourne des résultats en lecture seule. |
|
Execute(String, DataCommandType, array<IVsDataParameter[]) | Exécute une commande spécifiée, éventuellement avec des paramètres, et les résultats en lecture seule de retour. |
|
Execute(String, DataCommandType, array<IVsDataParameter[], Int32) | Exécute une commande spécifiée, éventuellement avec des paramètres, et les résultats en lecture seule de retour. |
|
ExecuteWithoutResults(String) | Exécute une commande mais ne demande pas de résultats, à la place retourne un entier indiquant les résultats de l'appel. |
|
ExecuteWithoutResults(String, DataCommandType) | Exécute une commande mais ne demande pas de résultats, à la place retourne un entier indiquant les résultats de l'appel. |
|
ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[]) | 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. |
|
ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[], Int32) | 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 d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.) |
|
OnSiteChanged | Déclenche l'événement SiteChanged. (Hérité de DataSiteableObject<T>.) |
|
Prepare(String) | 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. |
|
Prepare(String, DataCommandType) | 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. |
|
Prepare(String, DataCommandType, array<IVsDataParameter[]) | 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. |
|
Prepare(String, DataCommandType, array<IVsDataParameter[], Int32) | 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
Événements
| Nom | Description | |
|---|---|---|
.gif "Événement public") |
SiteChanged | Se produit lorsque la propriété Site est modifiée. (Hérité de DataSiteableObject<T>.) |
Début
Notes
Les fournisseurs concepteurs de (DDEX) d'extensibilité de données peuvent exécuter différents types de commandes sur une 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 présente les types de commande.Un type de commande indique une traduction de programmation d'une chaîne d'ordres donnée.Par exemple, un texte de commande peut informer le fournisseur de DDEX que la chaîne d'ordres est une instruction SQL qui doit être exécutée directement.Sinon, un type de TabularFunction peut informer le 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.
Technologies sous-jacentes telles que (Open Database Connectivity), l'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 offre une flexibilité en permettant aux fournisseurs de DDEX d'ajouter des types personnalisés de commande, ainsi que des descriptions de comment et quand les commandes peuvent être utilisées.
[!REMARQUE]
Pour permettre d'exécution de la commande de façon asynchrone, utilisez la classe d' DataAsyncCommand .Cette classe contient un ensemble de méthodes qui sont équivalentes à ceux de la classe d' DataCommand , mais ces méthodes fonctionnent de façon asynchrone.
Remarques à l'attention des héritiers
Lorsque vous héritez de la classe d' DataCommand , vous devez substituer chaque méthode de cette classe qui doit être prise en charge par son implémentation de fournisseur de DDEX.L'implémentation de base de chaque méthode de cette classe lève NotSupportedException.
Notez que la méthode d' ExecuteWithoutResults une implémentation de base qui délègue à l' Execute la méthode.
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.