Share via


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.ServiceProvider
    Microsoft.VisualStudio.Data.ServiceProviderWithSite
      Microsoft.VisualStudio.Data.DataConnectionSupport
        Microsoft.VisualStudio.Data.AdoDotNet.AdoDotNetConnectionSupport

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

Syntaxe

'Déclaration
Public MustInherit Class DataConnectionSupport _
    Inherits ServiceProviderWithSite _
    Implements IDisposable
public abstract class DataConnectionSupport : ServiceProviderWithSite, 
    IDisposable
public ref class DataConnectionSupport abstract : public ServiceProviderWithSite, 
    IDisposable
[<AbstractClass>]
type DataConnectionSupport =  
    class
        inherit ServiceProviderWithSite
        interface IDisposable
    end
public abstract class DataConnectionSupport extends ServiceProviderWithSite implements IDisposable

Le type DataConnectionSupport expose les membres suivants.

Constructeurs

  Nom Description
Méthode protégée DataConnectionSupport Constructeur de classe.Instancie une instance nonparameterized de la classe d' DataConnectionSupport .

Début

Propriétés

  Nom Description
Propriété publique ConnectionString Extrait ou définit une représentation sous forme de chaîne des informations requises pour établir une connexion à une source de données particulière.
Propriété publique ConnectionTimeout Extrait ou définit la durée, en secondes, à l'attente pour établir une connexion avant de terminer la tentative et générer une erreur de délai d'attente.
Propriété publique ProviderObject Récupère l'objet sous-jacent de fournisseur de données pour la connexion spécifiée.
Propriété protégée ServiceTypes Extrait une liste des types de service utilisés pour convertir l'appel de méthode non managé d' QueryService , dans lequel un service GUID est spécifié, dans un appel de méthode managé d' IServiceProvider.GetService , dans lequel un type managé est spécifié. (Hérité de ServiceProvider.)
Propriété publique Site Extrait ou définit l'instance de l'objet de site. (Hérité de ServiceProviderWithSite.)
Propriété publique State Récupère l'état de connexion de données.

Début

Méthodes

  Nom Description
Méthode publique Close Ferme la connexion spécifiée.
Méthode publique Dispose() Exécute les tâches associées à la libération ou à la redéfinition des ressources.
Méthode protégée Dispose(Boolean) Exécute les tâches associées à la libération ou à la redéfinition des ressources.
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 Finalise la connexion. (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 protégée GetServiceImpl(Type) Vous permet d'obtenir des services d'implémentation. (Substitue ServiceProvider.GetServiceImpl(Type).)
Méthode protégée GetServiceImpl(Guid) Fournit l'implémentation pour récupérer un service avec un GUID spécifique. (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 OnSiteChanged Déclenche l'événement SiteChanged. (Hérité de ServiceProviderWithSite.)
Méthode publique Open Ouvre la connexion spécifiée.
Méthode protégée RaiseMessageReceived Déclenche l'événement d' MessageReceivedsur l'instance englobante d' DataConnection .
Méthode protégée RaiseStateChanged Déclenche l'événement modifié par rapport à l'instance englobante d' DataConnection .
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 SiteChanged Événement déclenché lorsque la propriété d' Site a changé. (Hérité de ServiceProviderWithSite.)

Début

Implémentations d'interface explicite

  Nom Description
Implémentation d'interface expliciteMéthode privée IObjectWithSite.GetSite Récupère le dernier site défini à l'aide de la méthode d' IObjectWithSite.SetSite .Si aucun site, une exception est levée. (Hérité de ServiceProviderWithSite.)
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.)
Implémentation d'interface expliciteMéthode privée IObjectWithSite.SetSite Fournit le pointeur d' IUnknown d'un site à un objet donné. (Hérité de ServiceProviderWithSite.)

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.L'architecture de DDEX implémente la classe d' DataConnection en appelant DataConnectionSupport de fournisseur une implémentation spécifique.

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 davantage spécialisés en substituant la méthode d' GetServiceImpl .Ces services connexion connexion sont résumés suivants :

  • DataViewSupport: Fournit une méthode pour récupérer le XML qui décrit les vues spécifiques de source de données des objets de données à afficher dans l'explorateur de serveurs d' Visual Studio .

  • DataObjectSupport: 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.

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

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

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

  • DataCommand: Fournit la capacité de dériver et exécuter différents types de commandes.

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

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

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

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

Cette classe implémente l'interface d' IObjectWithSite , qui permet à DDEX pour localiser l'implémentation d' DataConnectionSupport d'un fournisseur de données avec l'objet d' DataConnection qui est appelant elle.Cela permet à l'implémentation au contexte, ainsi que des moyens de récupérer des services d' Visual Studio .

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' GetServiceImplpour fournir ses services de connexion.Lorsqu'une modification état ou un événement message- reçu se produit, une classe dérivée, dans la mesure du possible, appeler l' RaiseStateChanged et les méthodes protégés d' RaiseMessageReceived , que la classe de base puis transmet à l'objet situé d' DataConnection .

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, espace de noms

ServiceProviderWithSite

IDisposable