Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais
Nous recommandons d’utiliser Visual Studio 2017

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.

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

public abstract class DataConnectionSupport : DataSiteableServiceProvider<IVsDataConnection>, 
	IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

Le type DataConnectionSupport expose les membres suivants.

  NomDescription
Méthode protégéeDataConnectionSupportInitialise une nouvelle instance de la classe DataConnectionSupport.
Début

  NomDescription
Propriété publiqueConnectionStringObtient 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é publiqueConnectionTimeoutObtient 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éeParentProviderObtient l'instance actuelle du fournisseur de services parent. (Hérité de ServiceProvider.)
Propriété publiqueProviderObjectObtient le fournisseur de données sous-jacent, qui prend en charge la connexion de données actuelle.
Propriété protégéeServiceProviderObtient le fournisseur de services global d'Visual Studio.
Propriété publiqueSiteObtient ou définit le site. (Hérité de DataSiteableServiceProvider<T>.)
Propriété publiqueStateObtient l'état de la connexion de données.
Début

  NomDescription
Méthode publiqueAddService(Type, ServiceCreatorCallback)Ajoute le service spécifié à la collection interne de services. (Hérité de ServiceProvider.)
Méthode publiqueAddService(Type, Object)Ajoute le service spécifié à la collection interne de services. (Hérité de ServiceProvider.)
Méthode publiqueAddService(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 publiqueAddService(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 publiqueCloseFerme la connexion spécifiée.
Méthode protégéeCreateServiceCrée un objet de service, en spécifiant le type de service d'interface.
Méthode publiqueDispose()Il libère toutes les ressources utilisées par la connexion de données.
Méthode protégéeDispose(Boolean)Il libère toutes les ressources utilisées par la connexion de données.
Méthode publiqueEqualsDétermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeFinalizeIl 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 publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetService(Guid)Récupère un service avec un service spécifié un GUID. (Hérité de ServiceProvider.)
Méthode publiqueGetService(Type)Récupère un service du type spécifié. (Hérité de ServiceProvider.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueInitializeInitialise la connexion spécifiée, facultativement d'un objet existant de fournisseur de données.
Méthode protégéeMemberwiseCloneCrée une copie superficielle du Object actuel. (Hérité de Object.)
Méthode protégéeOnMessageReceivedGère l'événement MessageReceived.
Méthode protégéeOnSiteChangedDéclenche l'événement SiteChanged. (Hérité de DataSiteableServiceProvider<T>.)
Méthode protégéeOnStateChangedGère l'événement StateChanged.
Méthode publiqueOpenOuvre la connexion de données spécifiée.
Méthode publiqueRemoveService(Type)Supprime le service spécifié de la collection interne de services (Hérité de ServiceProvider.)
Méthode publiqueRemoveService(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 publiqueToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Début

  NomDescription
Événement publicMessageReceivedSe produit lorsqu'un message est envoyée la source de données.
Événement publicSiteChangedSe produit lorsque le site a changé. (Hérité de DataSiteableServiceProvider<T>.)
Événement publicStateChangedSe produit lorsque l'état de connexion de données a changé.
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeIServiceProvider.QueryServiceEffectue une fabrique pour les services qui sont exposés via une implémentation d' IServiceProvider. (Hérité de ServiceProvider.)
Début

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.

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.
Afficher: