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

System.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 une 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 lorsque vous établissez 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 nouvel objet de service, en spécifiant le type de service d'interface.
Méthode publique Dispose() Libère toutes les ressources détenues par la connexion de données.
Méthode protégée Dispose(Boolean) Libère toutes les ressources détenues 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 Libère toutes les ressources détenues par la connexion de données lorsque l'objet de prise en charge de connexion de données est détruit. (Substitue Object.Finalize().)
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (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, éventuellement d'un objet existant de fournisseur de données.
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet 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 d' 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, l'exécution de tâches telles que l'ouverture et les connexions fermeture et la récupération de l'état de connexion.Un fournisseur de données peut également exposer des services spécialisés en substituant la méthode d' CreateService .Les services connexion connexion actuels peuvent être résumés comme suit :

  • IVsDataObjectSupport: Fournit une méthode pour récupérer le XML qui décrit des objets de types 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 entre 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 capacité de dériver et exécuter différents types de commandes.

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

  • IVsDataTransaction: Permet de démarrer, valider, et comment annuler des transactions arrières.

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

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

  • IVsDataMappedObjectConverter: Enables fournissant un mappeur personnalisé des métadonnées spécifiques à la source de données dans des concepts connus pour une utilisation par d'un concepteur générique.

  • IVsDataObjectSelector: Enables l'obtention des métadonnées spécifiques à la source de données sur les objets définis dans le fichier XML de prise en charge d'objet de données.

  • IDSRefBuilder: Permet 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 d' IVsDataSiteableObject<T> , qui permet à DDEX pour localiser l'implémentation d' DataConnectionSupport d'un fournisseur de données avec l'objet d' IVsDataConnection qui est appelant elle.Cela permet à l'implémentation le contexte, ainsi que des moyens de récupérer 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 la connexion.Une classe dérivée doit substituer la méthode protégée d' CreateService pour fournir son implémentation des services de connexion.Lorsqu'une modification état ou un événement message- reçu se produit, une classe dérivée doit, si possible, appeler l' OnStateChanged et les méthodes protégés d' OnMessageReceived .

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