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

DataConnection, classe

Prend en charge une connexion à une source de données.

Object
  Microsoft.VisualStudio.Data.ServiceProvider
    Microsoft.VisualStudio.Data.DataConnection

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

public abstract class DataConnection : ServiceProvider, 
	ICloneable, IDisposable

Le type DataConnection expose les membres suivants.

  NomDescription
Méthode protégéeDataConnectionConstructeur de classe. Instancie une nouvelle instance de la classe DataConnection.
Début

  NomDescription
Propriété publiqueAsyncCommandRécupère un objet qui peut effectuer une dérivation et l'opération asynchrone des commandes dans la source de données.
Propriété publiqueCommandRécupère un objet qui peut effectuer une dérivation et l'exécution des commandes dans la source de données.
Propriété publiqueConnectionSupportRécupère l'objet sous-jacent en charge de connexion de fournisseur de données qui est utilisé pour prendre en charge l'instance actuelle de connexion de données.
Propriété publiqueConnectionTimeoutExtrait ou définit la durée, en secondes, avant une commande d'ouvrir les durées de connexion.
Propriété publiqueDisplayConnectionStringExtrait ou définit les informations de connexion non chiffrées sous forme de chaîne de DDEX-fournisseur- détail.
Propriété publiqueEncryptedConnectionStringExtrait ou définit les informations de connexion chiffrée sous forme de chaîne DPAPI- chiffrée et spécifique au fournisseur.
Propriété publiqueIsLockedForExclusiveAccessRécupère une valeur booléenne indiquant si la connexion actuelle est verrouillée par un client pour l'accès exclusif.
Propriété publiqueObjectChangeEventsRécupère un objet qui fournit un jeu d'événements déclenchés lorsque les objets de données dans la source de données sont ajoutés, modifiés, supprimés ou.
Propriété publiqueObjectIdentifierConverterRécupère un objet qui peut convertir des identificateurs d'objets de données des chaînes mises en forme aux parties non formatées et vice versa.
Propriété publiqueObjectIdentifierResolverRécupère un objet qui peut résoudre des identificateurs d'objet de données via l'expansion et la contraction.
Propriété publiqueObjectItemComparerRécupère un objet qui peut comparer des composants et des propriétés d'identificateur sur les objets de données.
Propriété publiqueObjectSupportRécupère un objet qui fournit un flux XML définissant les différents types d'objets de données de DDEX pris en charge par la connexion de données actuelle.
Propriété publiqueProviderRécupère l'identificateur unique du fournisseur de DDEX pour la connexion de données actuelle.
Propriété publiqueProviderObjectIsLockedRécupère une valeur booléenne indiquant si l'objet fournisseur sous-jacent de DDEX est verrouillé pour une utilisation par d'un client.
Propriété protégéeServiceTypesExtrait 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é publiqueSourceRécupère l'identificateur global unique (GUID) de la source de données pour la connexion de données active éventuelle.
Propriété publiqueSourceInformationRécupère un objet qui fournit un ensemble de paires nom/valeur connus qui décrivent les caractéristiques de la source de données.
Propriété publiqueSourceVersionComparerRécupère un objet qui vous permet de comparer les numéros de version spécifiques à la source de données.
Propriété publiqueStateRécupère l'état actuel de cette connexion de données.
Propriété publiqueTransactionRécupère un objet qui active le traitement des transactions ; autrement dit, vous permet de démarrer, valider, et restaurer des transactions dans la source de données.
Propriété publiqueViewSupportRécupère un objet qui fournit un flux XML qui définit différentes vues de données prises en charge par la connexion de données actuelle.
Début

  NomDescription
Méthode publiqueCloneCrée une instance clonée de cette connexion de données, qui conserve les mêmes propriétés et état de connexion que l'origine.
Méthode publiqueCloseFerme la connexion de données actuelle.
Méthode publiqueDispose()a la connexion de données actuelle et toutes ses ressources associées.
Méthode protégéeDispose(Boolean)Prend en charge l'infrastructure de DDEX et n'est pas destiné à être utilisé directement à partir de votre code.
Méthode publiqueEqualsDétermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode publiqueEquivalentToRécupère une valeur booléenne indiquant si les informations sur la connexion actuelle sont équivalentes, dans un sens au moment de le design, des informations de connexion spécifiées.
Méthode protégéeFinalizeFinalise la connexion. (Substitue Object.Finalize.)
Méthode publiqueGetExclusiveAccessProxyExtrait une instance de proxy qui permet à l'appelant l'accès exclusif à la connexion de données.
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetLockedProviderObject()Récupère l'objet sous-jacent de fournisseur de données, le cas échéant, qui prend en charge la connexion de données actuelle.
Méthode publiqueGetLockedProviderObject(Int32)Récupère l'objet sous-jacent de fournisseur de données, le cas échéant, qui prend en charge la connexion de données actuelle.
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 protégéeGetServiceImpl(Guid)Fournit l'implémentation pour récupérer un service avec un GUID spécifique. (Hérité de ServiceProvider.)
Méthode protégéeGetServiceImpl(Type)Fournit l'implémentation pour récupérer un service d'un type spécifique. (Hérité de ServiceProvider.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle du Object actuel. (Hérité de Object.)
Méthode protégéeOnMessageReceivedGestionnaire pour l'événement d' MessageReceived .
Méthode protégéeOnStateChangedGestionnaire pour l'événement d' StateChanged .
Méthode publiqueOpenOuvre la connexion de données.
Méthode publiqueReleaseExclusiveAccessProxyLibère un proxy exclusif existant d'accès, de la manière attendue par un appel à la méthode d' GetExclusiveAccessProxy .
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode publiqueUnlockProviderObjectDéverrouille un objet fournisseur de DDEX qui a été verrouillé à l'aide d'un appel à la méthode d' GetLockedProviderObject.
Début

  NomDescription
Événement publicMessageReceivedÉvénement qui est déclenché lorsqu'un message est envoyée la source de données.
Événement publicStateChangedÉvénement qui est déclenché lorsque l'état de connexion de données a changé.
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeICloneable.CloneCrée une nouvelle instance d'objet de Connexion qui est une copie de l'instance actuelle.
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

Cette classe fournit à la transmission de base d'une source de données, qui prend en charge des fonctionnalités telles que l'ouverture et de fermeture des connexions. Elle permet également d'accéder à un jeu des services qui exposent une fonctionnalité plus spécifique à la source de données.

DDEX fournit l'implémentation unique de cette classe ; aucun fournisseur de données ne doit fournir leur propre implémentation de la classe d' DataConnection . À la place, les fournisseurs de DDEX doivent implémenter la classe d' DataConnectionSupport, qui est ensuite encapsulé par l'instance d' DataConnection .

l'avantage de cette approche est qu'il permet à DDEX de fournir une fonctionnalité clé au client et au fournisseur de données : verrouillage de la connexion afin que plusieurs clients peuvent partager la même connexion sans générer de conflits. Avec cette architecture, les clients n'ont pas besoin de vous préoccuper du conflit entre eux, et les fournisseurs de données n'ont pas besoin de vous préoccuper de l'accès multithread.

La classe d' DataConnection accomplit ce niveau de verrouillage en servant d'objet proxy à l'instance de classe d' DataConnectionSupport, ainsi qu'en fournissant des objets proxy pour chaque service de DDEX disponible dans la connexion. Ces proxy implémentent chaque méthode et de propriété en verrouillant la connexion, appelez ensuite l'implémentation du fournisseur de données, déverrouillant la connexion.

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: