DataConnectionSupport, classe

Fournit des propriétés et des méthodes qui vous permettent de travailler directement avec les connexions à une source de données.

Hiérarchie d'héritage

Object
  Microsoft.VisualStudio.Data.Framework.ServiceProvider
    Microsoft.VisualStudio.Data.Framework.DataSiteableServiceProvider<IVsDataConnection>
      Microsoft.VisualStudio.Data.Framework.DataConnectionSupport
        Microsoft.VisualStudio.Data.Framework.AdoDotNet.AdoDotNetConnectionSupport

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

Syntaxe

'Déclaration
Public MustInherit Class DataConnectionSupport _
    Inherits DataSiteableServiceProvider(Of IVsDataConnection) _
    Implements IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents
public abstract class DataConnectionSupport : DataSiteableServiceProvider<IVsDataConnection>, 
    IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents
public ref class DataConnectionSupport abstract : public DataSiteableServiceProvider<IVsDataConnection^>, 
    IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents
[<AbstractClass>]
type DataConnectionSupport =  
    class 
        inherit DataSiteableServiceProvider<IVsDataConnection>
        interface IVsDataConnectionSupport 
        interface IServiceProvider 
        interface IDisposable 
        interface IVsDataConnectionEvents 
    end
public abstract class DataConnectionSupport extends DataSiteableServiceProvider<IVsDataConnection> implements IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

Le type DataConnectionSupport expose les membres suivants.

Constructeurs

  Nom Description
Méthode protégée DataConnectionSupport Initialise une nouvelle instance de la classe DataConnectionSupport.

Début

Propriétés

  Nom Description
Propriété publique ConnectionString Obtient ou définit la représentation sous forme de chaîne des informations requises pour établir une connexion à une source de données spécifiée.
Propriété publique ConnectionTimeout Obtient ou définit la durée d'attente pour établir une connexion avant de terminer la tentative et générer une erreur de délai d'attente.
Propriété protégée ParentProvider Obtient l'instance actuelle du fournisseur de services parent. (Hérité de ServiceProvider.)
Propriété publique ProviderObject Obtient le fournisseur de données sous-jacent, qui prend en charge la connexion de données actuelle.
Propriété protégée ServiceProvider Obtient le fournisseur de services global d'Visual Studio.
Propriété publique Site Obtient ou définit le site. (Hérité de DataSiteableServiceProvider<T>.)
Propriété publique State Obtient l'état de la connexion de données.

Début

Méthodes

  Nom Description
Méthode publique AddService(Type, ServiceCreatorCallback) Ajoute le service spécifié à la collection interne de services. (Hérité de ServiceProvider.)
Méthode publique AddService(Type, Object) Ajoute le service spécifié à la collection interne de services. (Hérité de ServiceProvider.)
Méthode publique AddService(Type, ServiceCreatorCallback, Boolean) Ajoute le service spécifié à la collection interne de services ou au conteneur parent de service. (Hérité de ServiceProvider.)
Méthode publique AddService(Type, Object, Boolean) Ajoute le service spécifié à la collection d'objets de service ou le conteneur parent de service. (Hérité de ServiceProvider.)
Méthode publique Close Ferme la connexion spécifiée.
Méthode protégée CreateService Crée un objet de service, en spécifiant le type de service d'interface.
Méthode publique Dispose() Il libère toutes les ressources utilisées par la connexion de données.
Méthode protégée Dispose(Boolean) Il libère toutes les ressources utilisées par la connexion de données.
Méthode publique Equals Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégée Finalize Il libère toutes les ressources utilisées par la connexion de données lorsque l'objet de support de connexion est détruit. (Substitue Object.Finalize.)
Méthode publique GetHashCode Sert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publique GetService(Guid) Récupère un service avec un service spécifié un GUID. (Hérité de ServiceProvider.)
Méthode publique GetService(Type) Récupère un service du type spécifié. (Hérité de ServiceProvider.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique Initialize Initialise la connexion spécifiée, facultativement d'un objet existant de fournisseur de données.
Méthode protégée MemberwiseClone Crée une copie superficielle du Object actuel. (Hérité de Object.)
Méthode protégée OnMessageReceived Gère l'événement MessageReceived.
Méthode protégée OnSiteChanged Déclenche l'événement SiteChanged. (Hérité de DataSiteableServiceProvider<T>.)
Méthode protégée OnStateChanged Gère l'événement StateChanged.
Méthode publique Open Ouvre la connexion de données spécifiée.
Méthode publique RemoveService(Type) Supprime le service spécifié de la collection interne de services (Hérité de ServiceProvider.)
Méthode publique RemoveService(Type, Boolean) Supprime le service spécifié de la collection interne de services ou du conteneur parent de service. (Hérité de ServiceProvider.)
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Événements

  Nom Description
Événement public MessageReceived Se produit lorsqu'un message est envoyée la source de données.
Événement public SiteChanged Se produit lorsque le site a changé. (Hérité de DataSiteableServiceProvider<T>.)
Événement public StateChanged Se produit lorsque l'état de connexion de données a changé.

Début

Implémentations d'interface explicite

  Nom Description
Implémentation d'interface expliciteMéthode privée IServiceProvider.QueryService Effectue une fabrique pour les services qui sont exposés via une implémentation d' IServiceProvider. (Hérité de ServiceProvider.)

Début

Notes

La classe DataConnectionSupport représente l'implémentation de fournisseur de données pour prendre en charge une connexion de données.

Les propriétés et les méthodes de cette classe fournissent les fonctionnalités de base qui permet au fournisseur de données pour communiquer avec la source de données, vous effectuez des tâches telles que l'ouverture et les connexions fermeture et extraction l'état de connexion. Un fournisseur de données peut également exposer des services spécialisés en substituant la méthode CreateService. Les services au liés actuels peuvent être les suivants :

  • IVsDataObjectSupport: Fournit une méthode de récupération de XML qui décrit les types d'objets de données pris en charge par la source de données et les actions qui peuvent être exécutées sur elles.

  • IVsDataObjectIdentifierResolver: Fournit une méthode pour résoudre des identificateurs d'objets de données.

  • IVsDataObjectIdentifierConverter: Fournit des méthodes pour convertir la chaîne et les représentations de tableau des identificateurs d'objets de données.

  • IVsDataObjectMemberComparer: Fournit des méthodes pour comparer des composants et des valeurs de propriété d'identificateur d'objet de données.

  • IVsDataCommand: Fournit la possibilité de dériver et exécuter divers types de commandes.

  • IVsDataAsyncCommand: Active exécuter des commandes de données de manière asynchrone.

  • IVsDataTransaction: Fournit la possibilité de commencer, valider, et restaurer les transactions retourner.

  • IVsDataSourceVersionComparer: Fournit une méthode pour comparer deux chaînes spécifiques à la source de données de version.

  • IVsDataSourceInformation: Fournit un jeu de paires nom/valeur bien définies qui décrivent la source de données.

  • IVsDataMappedObjectConverter: Permet fournissant un mappeur personnalisé des métadonnées spécifiques à la source de données dans des concepts connus en vue de concepteur générique.

  • IVsDataObjectSelector: Permet obtenir des métadonnées spécifiques à la source de données sur les objets définis dans le fichier XML du média d'objet de données.

  • IDSRefBuilder: Fournit la possibilité de créer un objet de (DSRef) de référence de source de données qui identifie un ou plusieurs objets de données.

Cette classe implémente l'interface IVsDataSiteableObject<T>, qui permet à DDEX lier l'implémentation d'DataConnectionSupport d'un fournisseur de données avec l'objet IVsDataConnection qui est appelant dedans. Cela fournit l'implémentation le contexte, ainsi que de moyen d'extraire des services d'Visual Studio.

Remarques à l'attention des héritiers

Toute classe dérivée doit appliquer les propriétés et méthodes abstraites pour prendre en charge leur connexion. Une classe dérivée doit substituer la méthode CreateService protégée fournisse son implémentation des services de connexion. Lorsqu'une état modification ou un événement par reçu se produit, une classe dérivée doit, si possible, appeler les méthodes OnStateChanged et OnMessageReceived protégés.

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.

Voir aussi

Référence

Microsoft.VisualStudio.Data.Framework, espace de noms