EntityConnection Classe

Définition

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

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 :

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 à

Voir aussi