EntityConnection Classe

Référence

Définition

Espace de noms:: System.Data.EntityClient

Assembly:: System.Data.Entity.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 la désynchronisation par inadvertance d’objets tels que System.Data.Common.CommandTrees et ObjectContext avec leurs métadonnées, EntityConnection doit verrouiller ses métadonnées. Le verrouillage des métadonnées interdit toute modification de la chaîne de connexion. Deux situations dans lesquelles les métadonnées sont verrouillées sont présentées ci-dessous :

Le EntityConnection instance est construit via le constructeur sans paramètre ou par le biais du EntityConnection(String) constructeur, qui accepte une chaîne de connexion. Dans les deux cas, la chaîne de connexion peut être modifiée plus fois avant l'ouverture de la connexion. L'appel à Open ou GetMetadataWorkspace verrouille les métadonnées.
L'instance EntityConnection est créée par l'intermédiaire du constructeur EntityConnection(MetadataWorkspace, DbConnection), qui accepte un MetadataWorkspace et un DbConnection. Dans ce cas, les métadonnées sont verrouillées lors de la construction. Aucune modification de la chaîne de connexion ne peut plus être effectuée.

Lors du chargement des métadonnées, EntityConnection vérifie que le 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

EntityConnection()	Initialise une nouvelle instance de la classe EntityConnection.
EntityConnection(MetadataWorkspace, DbConnection)	Initialise une nouvelle instance de la classe EntityConnection avec un MetadataWorkspace et un DbConnection spécifiés.
EntityConnection(String)	Initialise une nouvelle instance de la classe EntityConnection, selon la chaîne de connexion.

Propriétés

CanCreateBatch	Obtient une valeur qui indique si cette instance DbConnection prend en charge la classe DbBatch. (Hérité de DbConnection)
CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
ConnectionString	Obtient ou définit la chaîne de connexion EntityConnection.
ConnectionTimeout	Obtient, en nombre de secondes, la durée d'attente préalable à l'établissement d'une connexion avant que la tentative ne soit abandonnée et qu'une erreur ne soit générée.
Container	Obtient le IContainer qui contient la Component. (Hérité de Component)
Database	Obtient le nom de la base de données actuelle ou de celle à utiliser une fois la connexion établie.
DataSource	Obtient le nom ou l'adresse réseau de la source de données à laquelle se connecter.
DbProviderFactory	Obtient le DbProviderFactory pour ce DbConnection. (Hérité de DbConnection)
DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
Events	Obtient la liste des gestionnaires d'événements 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 propriété ConnectionState du fournisseur sous-jacent si la connexion EntityConnection est établie. Sinon, retourne Closed.
StoreConnection	Fournit l'accès à la connexion à la source de données sous-jacente qui est utilisée par l'objet EntityConnection.

Méthodes

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)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Démarre de manière asynchrone 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.
BeginTransactionAsync(CancellationToken)	Commence de manière asynchrone une transaction de base de données. (Hérité de DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Commence de manière asynchrone une transaction de base de données. (Hérité de DbConnection)
ChangeDatabase(String)	Non pris en charge.
ChangeDatabaseAsync(String, CancellationToken)	Change de manière asynchrone la base de données actuelle pour une connexion ouverte. (Hérité de DbConnection)
Close()	Ferme la connexion à la base de données.
CloseAsync()	Ferme de manière asynchrone la connexion à la base de données. (Hérité de DbConnection)
CreateBatch()	Retourne une nouvelle instance de la classe du fournisseur qui implémente la classe DbBatch. (Hérité de DbConnection)
CreateCommand()	Crée une instance d'un objet EntityCommand, avec la propriété Connection ayant pour valeur EntityConnection.
CreateDbBatch()	En cas de substitution dans une classe dérivée, retourne une nouvelle instance de la classe du fournisseur qui implémente la DbBatch classe . (Hérité de DbConnection)
CreateDbCommand()	En cas de substitution dans une classe dérivée, crée et retourne un objet DbCommand associé à la connexion active. (Hérité de DbConnection)
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées. (Hérité de DbConnection)
Dispose(Boolean)	Libère les ressources non managées utilisées par DbConnection et libère éventuellement les ressources managées. (Hérité de DbConnection)
DisposeAsync()	Supprime de manière asynchrone l’objet de connexion. (Hérité de DbConnection)
EnlistTransaction(Transaction)	Inscrit ce EntityConnection dans la transaction spécifiée.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetMetadataWorkspace()	Retourne l'objet MetadataWorkspace associé à cet objet EntityConnection.
GetSchema()	Retourne les informations de schéma pour la source de données de ce DbConnection. (Hérité de DbConnection)
GetSchema(String)	Retourne des informations de schéma pour la source de données de ce DbConnection à l’aide de la chaîne spécifiée pour le nom de schéma. (Hérité de DbConnection)
GetSchema(String, String[])	Retourne les informations de schéma pour la source de données de ce DbConnection à l’aide de la chaîne spécifiée pour le nom de schéma et du tableau de chaînes spécifié pour les valeurs de restriction. (Hérité de DbConnection)
GetSchemaAsync(CancellationToken)	Il s'agit d’une version asynchrone de GetSchema(). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le `cancellationToken` peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode GetSchema() synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un `cancellationToken` déjà annulé est passé. Les exceptions levées par GetSchema() sont communiquées via la propriété d'exception de tâche retournée. (Hérité de DbConnection)
GetSchemaAsync(String, CancellationToken)	Il s'agit de la version asynchrone de GetSchema(String). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le `cancellationToken` peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode GetSchema(String) synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un `cancellationToken` déjà annulé est passé. Les exceptions levées par GetSchema(String) sont communiquées via la propriété d'exception de tâche retournée. (Hérité de DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Il s'agit de la version asynchrone de GetSchema(String, String[]). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le `cancellationToken` peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode GetSchema(String, String[]) synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un `cancellationToken` déjà annulé est passé. Les exceptions levées par GetSchema(String, String[]) sont communiquées via la propriété d'exception de tâche retournée. (Hérité de DbConnection)
GetService(Type)	Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. 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 Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (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 `Open` du fournisseur de données.
OpenAsync()	Version asynchrone de Open(), qui ouvre une connexion de base de données avec les paramètres spécifiés par ConnectionString. Cette méthode appelle la méthode virtuelle OpenAsync(CancellationToken) avec CancellationToken.None. (Hérité de DbConnection)
OpenAsync(CancellationToken)	Il s'agit de la version asynchrone de Open(). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le jeton d'annulation peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode Open() synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé. Les exceptions levées par Open sont communiquées via la propriété d'exception de tâche retournée. N'appelle pas d'autres méthodes et propriétés de l'objet `DbConnection` jusqu'à ce que la tâche retournée soit terminée. (Hérité de DbConnection)
ToString()	Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée. (Hérité de Component)

Événements

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

Implémentations d’interfaces explicites

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’isolement spécifié. (Hérité de DbConnection)
IDbConnection.CreateCommand()	Crée et retourne un objet DbCommand associé à la connexion actuelle. (Hérité de DbConnection)

S’applique à