Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

EntityConnection, classe

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.

Espace de noms :  System.Data.EntityClient
Assembly :  System.Data.Entity (dans System.Data.Entity.dll)

public sealed class EntityConnection : DbConnection

Le type EntityConnection expose les membres suivants.

  NomDescription
Méthode publiqueEntityConnection()Initialise une nouvelle instance de la classe EntityConnection.
Méthode publiqueEntityConnection(String)Initialise une nouvelle instance de la classe EntityConnection, en fonction de la chaîne de connexion.
Méthode publiqueEntityConnection(MetadataWorkspace, DbConnection)Initialise une nouvelle instance de la classe EntityConnection avec les MetadataWorkspace et DbConnection spécifiés.
Début

  NomDescription
Propriété protégéeCanRaiseEventsObtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component.)
Propriété publiqueConnectionStringObtient ou définit la chaîne de connexion EntityConnection. (Substitue DbConnection.ConnectionString.)
Propriété publiqueConnectionTimeoutObtient le délai d'attente, en nombre de secondes, préalable à l'établissement d'une connexion au-delà duquel la tentative est abandonnée et une erreur est générée. (Substitue DbConnection.ConnectionTimeout.)
Propriété publiqueContainerObtient le IContainer qui contient Component. (Hérité de Component.)
Propriété publiqueDatabaseObtient le nom de la base de données active ou de la base de données qui sera utilisée après l'ouverture d'une connexion. (Substitue DbConnection.Database.)
Propriété publiqueDataSourceObtient le nom ou l'adresse de réseau de la source de données à laquelle se connecter. (Substitue DbConnection.DataSource.)
Propriété protégéeDbProviderFactoryObtient DbProviderFactory pour DbConnection. (Hérité de DbConnection.)
Propriété protégéeDesignModeObtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component.)
Propriété protégéeEventsObtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component.)
Propriété publiqueServerVersionObtient une chaîne qui contient la version de la source de données à laquelle le client est connecté. (Substitue DbConnection.ServerVersion.)
Propriété publiqueSiteObtient ou définit le ISite de Component. (Hérité de Component.)
Propriété publiqueStateObtient la propriété ConnectionState du fournisseur de données sous-jacent si l'EntityConnection est ouverte. Sinon, retourne Closed. (Substitue DbConnection.State.)
Propriété publiqueStoreConnectionPermet d'accéder à la connexion de source de données sous-jacente qui est utilisée par l'objet EntityConnection.
Début

  NomDescription
Méthode protégéeBeginDbTransactionCommence une transaction de base de données. (Hérité de DbConnection.)
Méthode publiqueBeginTransaction()Commence une transaction à l'aide du fournisseur sous-jacent.
Méthode publiqueBeginTransaction(IsolationLevel)Commence une transaction avec le niveau d'isolement spécifié et à l'aide du fournisseur sous-jacent.
Méthode publiqueChangeDatabaseNon pris en charge. (Substitue DbConnection.ChangeDatabase(String).)
Méthode publiqueCloseFerme la connexion à la base de données. (Substitue DbConnection.Close().)
Méthode publiqueCreateCommandCrée une nouvelle instance de EntityCommand, dont l'Connection est affectée à l'EntityConnection courante.
Méthode protégéeCreateDbCommandCrée et retourne un objet DbCommand associé à la connexion active. (Hérité de DbConnection.)
Méthode publiqueCreateObjRefCré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.)
Méthode publiqueDispose()Libère toutes les ressources utilisées par Component. (Hérité de Component.)
Méthode protégéeDispose(Boolean)Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées. (Hérité de Component.)
Méthode publiqueEnlistTransactionInscrit cet objet EntityConnection dans la transaction spécifiée. (Substitue DbConnection.EnlistTransaction(Transaction).)
Méthode publiqueEquals(Object)Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégéeFinalizeLibère les ressources non managées et exécute d'autres opérations de nettoyage avant la récupération de Component par le garbage collection. (Hérité de Component.)
Méthode publiqueGetHashCodeSert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publiqueGetLifetimeServiceRé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.)
Méthode publiqueGetMetadataWorkspaceRetourne le MetadataWorkspace associé à ce EntityConnection.
Méthode publiqueGetSchema()Retourne les informations de schéma pour la source de données de ce DbConnection. (Hérité de DbConnection.)
Méthode publiqueGetSchema(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.)
Méthode publiqueGetSchema(String, 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 et du tableau de chaînes spécifié pour les valeurs de restriction. (Hérité de DbConnection.)
Méthode protégéeGetServiceRetourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueInitializeLifetimeServiceObtient 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.)
Méthode protégéeMemberwiseClone()Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégéeMemberwiseClone(Boolean)Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject.)
Méthode protégéeOnStateChangeDéclenche l'événement StateChange. (Hérité de DbConnection.)
Méthode publiqueOpenÉtablit une connexion à la source de données en appelant la méthode Open du fournisseur de données. (Substitue DbConnection.Open().)
Méthode publiqueToStringRetourne String contenant le nom du Component, s'il existe. Cette méthode ne doit pas être substituée. (Hérité de Component.)
Début

  NomDescription
Événement publicDisposedSe produit lorsque le composant est supprimé par un appel à la méthode Dispose. (Hérité de Component.)
Événement publicStateChangeSe produit lorsque l'état de l'événement change. (Hérité de DbConnection.)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeIDbConnection.BeginTransaction()Commence une transaction de base de données. (Hérité de DbConnection.)
Implémentation d'interface expliciteMéthode privéeIDbConnection.BeginTransaction(IsolationLevel)Commence une transaction de base de données avec la valeur IsolationLevel spécifiée. (Hérité de DbConnection.)
Implémentation d'interface expliciteMéthode privéeIDbConnection.CreateCommandCrée et retourne un objet DbCommand associé à la connexion active. (Hérité de DbConnection.)
Début

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 :

  • L'instance EntityConnection est créée par l'intermédiaire du constructeur par défaut ou du constructeur EntityConnection(String), 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 à [M:System.Data.EntityClient.EntityConnection.Open()] ou [M:System.Data.EntityClient.EntityConnection.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 Working with EntityClient.

.NET Framework

Pris en charge dans : 4, 3.5 SP1

.NET Framework Client Profile

Pris en charge dans : 4

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

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.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft