EntityConnection Classe

Définition

Espace de noms:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

Contient une référence à un modèle conceptuel et à une connexion de source de données. Cette classe ne peut pas être héritée.

public ref class EntityConnection sealed : System::Data::Common::DbConnection

public sealed class EntityConnection : System.Data.Common.DbConnection

type EntityConnection = class
    inherit DbConnection

Public NotInheritable Class EntityConnection
Inherits DbConnection

Héritage

Object

MarshalByRefObject

Component

DbConnection

EntityConnection

Remarques

Pour éviter de placer par inadvertance des objets tels que System.Data.Common.CommandTrees et ObjectContext hors synchronisation avec leurs métadonnées, EntityConnection vous devez verrouiller ses métadonnées. Aucune modification de la chaîne de connexion n’est autorisée une fois les métadonnées verrouillées. Voici deux scénarios dans lesquels les métadonnées sont verrouillées :

• L’instance EntityConnection est construite via le constructeur sans paramètre, ou via le constructeur EntityConnection(String), qui accepte un chaîne de connexion. Dans les deux cas, le chaîne de connexion peut être modifié plusieurs fois avant l’ouverture de la connexion. Appeler Open ou GetMetadataWorkspace verrouiller les métadonnées.

• L’instance EntityConnection est construite par le biais du EntityConnection(MetadataWorkspace, DbConnection) constructeur, qui accepte un MetadataWorkspace et un DbConnection. Dans ce cas, les métadonnées sont verrouillées au moment de la construction. Aucune modification de la chaîne de connexion n’est jamais autorisée.

Lorsque les métadonnées sont chargées, le EntityConnection modèle conceptuel, le modèle de stockage et le fichier de mappage sont tous présents.

Pour obtenir des exemples de code, consultez Utilisation d’EntityClient.

Constructeurs

Nom	Description
EntityConnection()	Initialise une nouvelle instance de la classe EntityConnection.
EntityConnection(MetadataWorkspace, DbConnection)	Initialise une nouvelle instance de la EntityConnection classe avec un élément spécifié MetadataWorkspace et DbConnection.
EntityConnection(String)	Initialise une nouvelle instance de la classe EntityConnection, en fonction de la chaîne de connexion.

Propriétés

Nom	Description
CanRaiseEvents	Obtient une valeur indiquant si le composant peut déclencher un événement. (Hérité de Component)
ConnectionString	Obtient ou définit le EntityConnection chaîne de connexion.
ConnectionTimeout	Obtient le nombre de secondes à attendre lors de la tentative d’établissement d’une connexion avant de terminer la tentative et de générer une erreur.
Container	Obtient le IContainer fichier qui contient le Component. (Hérité de Component)
Database	Obtient le nom de la base de données active ou la base de données qui sera utilisée après l’ouverture d’une connexion.
DataSource	Obtient le nom ou l’adresse réseau de la source de données à laquelle se connecter.
DbProviderFactory	Obtient la DbProviderFactory valeur de ce DbConnection. (Hérité de DbConnection)
DesignMode	Obtient une valeur qui indique si la Component valeur est actuellement en mode création. (Hérité de Component)
Events	Obtient la liste des gestionnaires d’événements qui sont attachés à ce Component. (Hérité de Component)
ServerVersion	Obtient une chaîne qui contient la version de la source de données à laquelle le client est connecté.
Site	Obtient ou définit le ISite de Component. (Hérité de Component)
State	Obtient la ConnectionState propriété du fournisseur sous-jacent si elle EntityConnection est ouverte. Sinon, retourne Closed.
StoreConnection	Fournit l’accès à la connexion de source de données sous-jacente utilisée par l’objet EntityConnection .

Méthodes

Nom	Description
BeginDbTransaction(IsolationLevel)	En cas de substitution dans une classe dérivée, démarre une transaction de base de données. (Hérité de DbConnection)
BeginTransaction()	Commence une transaction à l’aide du fournisseur sous-jacent.
BeginTransaction(IsolationLevel)	Commence une transaction avec le niveau d’isolation spécifié à l’aide du fournisseur sous-jacent.
ChangeDatabase(String)	Non pris en charge.
Close()	Ferme la connexion à la base de données.
CreateCommand()	Crée une instance d’un EntityCommand, avec la Connection valeur définie sur ce EntityConnection.
CreateDbCommand()	En cas de substitution dans une classe dérivée, crée et retourne un DbCommand objet associé à la connexion actuelle. (Hérité de DbConnection)
CreateObjRef(Type)	Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject)
EnlistTransaction(Transaction)	Inscrit cette opération EntityConnection dans la transaction spécifiée.
Equals(Object)	Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetMetadataWorkspace()	Retourne l’associé MetadataWorkspace à ce EntityConnectionfichier .
GetSchema()	Retourne des informations de schéma pour la source de données de ce DbConnection. (Hérité de DbConnection)
GetSchema(String, String[])	Retourne des informations de schéma pour la source de données de cette DbConnection méthode à l’aide de la chaîne spécifiée pour le nom du schéma et du tableau de chaînes spécifié pour les valeurs de restriction. (Hérité de DbConnection)
GetSchema(String)	Retourne des informations de schéma pour la source de données de cette DbConnection méthode à l’aide de la chaîne spécifiée pour le nom du schéma. (Hérité de DbConnection)
GetService(Type)	Retourne un objet qui représente un service fourni par le Component ou par son Container. (Hérité de Component)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Déclenche l’événement StateChange. (Hérité de DbConnection)
Open()	Établit une connexion à la source de données en appelant la méthode du fournisseur de Open données sous-jacent.
OpenAsync()	Version asynchrone de , qui ouvre une connexion de base de Open()données avec les paramètres spécifiés par le ConnectionString. Cette méthode appelle la méthode OpenAsync(CancellationToken) virtuelle avec CancellationToken.None. (Hérité de DbConnection)
OpenAsync(CancellationToken)	Il s’agit de la version asynchrone de Open(). Les fournisseurs doivent remplacer par une implémentation appropriée. Le jeton d’annulation peut éventuellement être honoré. L’implémentation par défaut appelle l’appel synchrone Open() et retourne une tâche terminée. L’implémentation par défaut retourne une tâche annulée si elle a passé une annulation d’annulationToken. Les exceptions levées par Open seront communiquées via la propriété Exception de tâche retournée. N’appelez pas d’autres méthodes et propriétés de l’objet DbConnection tant que la tâche retournée n’est pas terminée. (Hérité de DbConnection)
ToString()	Retourne un String nom contenant le nom du Component, le cas échéant. Cette méthode ne doit pas être remplacée. (Hérité de Component)

Événements

Nom	Description
Disposed	Se produit lorsque le composant est supprimé par un appel à la Dispose() méthode. (Hérité de Component)
StateChange	Se produit lorsque l’état de la connexion change. (Hérité de DbConnection)

Implémentations d’interfaces explicites

Nom	Description
IDbConnection.BeginTransaction()	Commence une transaction de base de données. (Hérité de DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Commence une transaction de base de données avec le niveau d’isolation spécifié. (Hérité de DbConnection)
IDbConnection.CreateCommand()	Crée et retourne un DbCommand objet associé à la connexion actuelle. (Hérité de DbConnection)

Voir aussi

• Fournisseur EntityClient pour Entity Framework
• Chaîne de connexion