DataConnection, classe

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

Hiérarchie d'héritage

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

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

Syntaxe

'Déclaration
Public MustInherit Class DataConnection _
    Inherits ServiceProvider _
    Implements ICloneable, IDisposable

public abstract class DataConnection : ServiceProvider, 
    ICloneable, IDisposable

public ref class DataConnection abstract : public ServiceProvider, 
    ICloneable, IDisposable

[<AbstractClass>]
type DataConnection =  
    class 
        inherit ServiceProvider 
        interface ICloneable 
        interface IDisposable 
    end

public abstract class DataConnection extends ServiceProvider implements ICloneable, IDisposable

Le type DataConnection expose les membres suivants.

Constructeurs

	Nom	Description
	DataConnection	Constructeur de classe.Instancie une nouvelle instance de la classe DataConnection.

Début

Propriétés

	Nom	Description
	AsyncCommand	Récupère un objet qui peut effectuer une dérivation et l'opération asynchrone des commandes dans la source de données.
	Command	Récupère un objet qui peut effectuer une dérivation et l'exécution des commandes dans la source de données.
	ConnectionSupport	Ré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.
	ConnectionTimeout	Extrait ou définit la durée, en secondes, avant une commande d'ouvrir les durées de connexion.
	DisplayConnectionString	Extrait ou définit les informations de connexion non chiffrées sous forme de chaîne de DDEX-fournisseur- détail.
	EncryptedConnectionString	Extrait ou définit les informations de connexion chiffrée sous forme de chaîne DPAPI- chiffrée et spécifique au fournisseur.
	IsLockedForExclusiveAccess	Récupère une valeur booléenne indiquant si la connexion actuelle est verrouillée par un client pour l'accès exclusif.
	ObjectChangeEvents	Ré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.
	ObjectIdentifierConverter	Ré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.
	ObjectIdentifierResolver	Récupère un objet qui peut résoudre des identificateurs d'objet de données via l'expansion et la contraction.
	ObjectItemComparer	Récupère un objet qui peut comparer des composants et des propriétés d'identificateur sur les objets de données.
	ObjectSupport	Ré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.
	Provider	Récupère l'identificateur unique du fournisseur de DDEX pour la connexion de données actuelle.
	ProviderObjectIsLocked	Récupère une valeur booléenne indiquant si l'objet fournisseur sous-jacent de DDEX est verrouillé pour une utilisation par d'un client.
	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.)
	Source	Récupère l'identificateur global unique (GUID) de la source de données pour la connexion de données active éventuelle.
	SourceInformation	Ré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.
	SourceVersionComparer	Récupère un objet qui vous permet de comparer les numéros de version spécifiques à la source de données.
	State	Récupère l'état actuel de cette connexion de données.
	Transaction	Ré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.
	ViewSupport	Ré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

Méthodes

	Nom	Description
	Clone	Cré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.
	Close	Ferme la connexion de données actuelle.
	Dispose()	a la connexion de données actuelle et toutes ses ressources associées.
	Dispose(Boolean)	Prend en charge l'infrastructure de DDEX et n'est pas destiné à être utilisé directement à partir de votre code.
	Equals	Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
	EquivalentTo	Ré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.
	Finalize	Finalise la connexion. (Substitue Object.Finalize.)
	GetExclusiveAccessProxy	Extrait une instance de proxy qui permet à l'appelant l'accès exclusif à la connexion de données.
	GetHashCode	Sert de fonction de hachage par défaut. (Hérité de Object.)
	GetLockedProviderObject()	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.
	GetLockedProviderObject(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.
	GetService(Guid)	Récupère un service avec un service spécifié un GUID. (Hérité de ServiceProvider.)
	GetService(Type)	Récupère un service du type spécifié. (Hérité de ServiceProvider.)
	GetServiceImpl(Guid)	Fournit l'implémentation pour récupérer un service avec un GUID spécifique. (Hérité de ServiceProvider.)
	GetServiceImpl(Type)	Fournit l'implémentation pour récupérer un service d'un type spécifique. (Hérité de ServiceProvider.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	MemberwiseClone	Crée une copie superficielle du Object actuel. (Hérité de Object.)
	OnMessageReceived	Gestionnaire pour l'événement d' MessageReceived .
	OnStateChanged	Gestionnaire pour l'événement d' StateChanged .
	Open	Ouvre la connexion de données.
	ReleaseExclusiveAccessProxy	Libère un proxy exclusif existant d'accès, de la manière attendue par un appel à la méthode d' GetExclusiveAccessProxy .
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
	UnlockProviderObject	Déverrouille un objet fournisseur de DDEX qui a été verrouillé à l'aide d'un appel à la méthode d' GetLockedProviderObject.

Début

Événements

	Nom	Description
	MessageReceived	Événement qui est déclenché lorsqu'un message est envoyée la source de données.
	StateChanged	Événement qui est déclenché lorsque l'état de connexion de données a changé.

Début

Implémentations d'interface explicite

	Nom	Description
	ICloneable.Clone	Crée une nouvelle instance d'objet de Connexion qui est une copie de l'instance actuelle.
	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

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.

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

ICloneable

IDisposable