Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[Cette page concerne Entity Framework version 6. La dernière version est disponible sous le nom de package 'Entity Framework' NuGet. Pour plus d'informations sur Entity Framework, consultez msdn.com/data/ef.]
L'espace de noms System.Data.Entity.Infrastructure contient des classes qui prennent en charge les fonctionnalités Entity Framework principales.
Classes
Classe | Description | |
---|---|---|
![]() |
CommitFailedException | Exception levée lorsqu'une erreur se produit lors de la validation d'un DbTransaction. |
![]() |
CommitFailureHandler | Représente un gestionnaire de transactions qui permet une récupération appropriée après des échecs de connexion pendant la validation de transaction en stockant des informations de suivi de transaction dans la base de données.Il doit être inscrit à l'aide de SetDefaultTransactionHandler(Func<TransactionHandler>). |
![]() |
DbChangeTracker | Retourné par la méthode ChangeTracker de DbContext pour fournir l'accès aux fonctionnalités du contexte mises en rapport avec le suivi des modifications d'entités. |
![]() |
DbCollectionEntry | Représente une version non générique de la classe DbCollectionEntry<TEntity, TElement>. |
![]() |
DbCollectionEntry<TEntity, TElement> | Les instances de cette classe sont retournées à partir de la méthode Collection de DbEntityEntry<TEntity> et autorisent des opérations telles que le chargement sur les propriétés de navigation de collection d'une entité. |
![]() |
DbCompiledModel | Représentation immuable d'un modèle Entity Data Model (EDM) qui peut être utilisé pour créer un ObjectContext ou peut être passé au constructeur d'un DbContext.Pour de meilleures performances, les instances de ce type doivent être mises en cache et réutilisées pour construire des contextes. |
![]() |
DbComplexPropertyEntry | Version non générique de la classe DbComplexPropertyEntry<TEntity, TComplexProperty>. |
![]() |
DbComplexPropertyEntry<TEntity, TComplexProperty> | Les instances de cette classe sont retournées à partir de la méthode ComplexProperty de DbEntityEntry<TEntity> et autorisent l'accès à l'état d'une propriété complexe. |
![]() |
DbConnectionInfo | Représente les informations relatives à une connexion de base de données. |
![]() |
DbContextConfiguration | Retourné par la méthode de configuration de DbContext pour fournir l'accès aux options de configuration pour le contexte. |
![]() |
DbContextInfo | Fournit les informations d'exécution concernant un type de DbContext spécifique. |
![]() |
DbEntityEntry | Version non générique de la classe DbEntityEntry<TEntity>. |
![]() |
DbEntityEntry<TEntity> | Les instances de cette classe donnent accès aux informations relatives aux entités suivies par le DbContext et au contrôle de celles-ci.Utilisez les méthodes Entity ou Entities du contexte pour obtenir des objets de ce type. |
![]() |
DbExecutionStrategy | Fournit l'implémentation de base du mécanisme de nouvelle tentative pour les opérations non fiables et les conditions temporaires avec un délai augmentant de façon exponentielle entre les tentatives consécutives. |
![]() |
DbMemberEntry | Classe de base abstraite utilisée pour représenter une propriété scalaire ou complexe, ou une propriété de navigation d'une entité.Les propriétés scalaires et complexes utilisent la classe dérivée DbPropertyEntry, les propriétés de navigation de référence utilisent la classe dérivée DbReferenceEntry et les propriétés de navigation de collection utilisent la classe dérivée DbCollectionEntry. |
![]() |
DbMemberEntry<TEntity, TProperty> | Classe de base abstraite utilisée pour représenter une propriété scalaire ou complexe, ou une propriété de navigation d'une entité.Les propriétés scalaires et complexes utilisent la classe dérivée DbPropertyEntry<TEntity, TProperty>, les propriétés de navigation de référence utilisent la classe dérivée DbReferenceEntry<TEntity, TProperty> et les propriétés de navigation de collection utilisent la classe dérivée DbCollectionEntry<TEntity, TElement>. |
![]() |
DbModel | Représente un Entity Data Model (EDM) créé par le DbModelBuilder.La méthode Compile peut être utilisée pour la conversion de cette représentation EDM vers un DbCompiledModel qui est un instantané compilé du modèle approprié pour la mise en cache et la création d'instances DbContext ou ObjectContext. |
![]() |
DbPropertyEntry | Version non générique de la classe DbPropertyEntry<TEntity, TProperty>. |
![]() |
DbPropertyEntry<TEntity, TProperty> | Les instances de cette classe sont retournées à partir de la méthode Property de DbEntityEntry<TEntity> et autorisent l'accès à l'état d'une propriété scalaire. |
![]() |
DbPropertyValues | Collection de toutes les propriétés pour une entité sous-jacente ou un objet complexe. |
![]() |
DbProviderInfo | Groupes de paires de chaînes qui identifient un fournisseur et une version de serveur dans un objet unique. |
![]() |
DbQuery | Représente une requête LINQ to Entities non générique sur un DbContext. |
![]() |
DbQuery<TResult> | Représente une requête LINQ to Entities sur un DbContext. |
![]() |
DbRawSqlQuery | Représente une requête SQL pour les non-entités créées à partir d'un DbContext qui est exécuté à l'aide de la connexion de ce contexte.Les instances de cette classe sont obtenues de l'instance Database.La requête n'est pas exécutée lorsque cet objet est créé ; elle est exécutée chaque fois qu'elle est énumérée, par exemple en utilisant l'instruction « foreach ».Les requêtes SQL pour les entités sont créées à l'aide de SqlQuery(String, Object[]).Consultez DbRawSqlQuery<TElement> pour une version générique de cette classe. |
![]() |
DbRawSqlQuery<TElement> | Représente une requête SQL pour les non-entités créées à partir d'un DbContext qui est exécuté à l'aide de la connexion de ce contexte.Les instances de cette classe sont obtenues de l'instance Database.La requête n'est pas exécutée lorsque cet objet est créé ; elle est exécutée chaque fois qu'elle est énumérée, par exemple en utilisant l'instruction « foreach ».Les requêtes SQL pour les entités sont créées à l'aide de SqlQuery(String, Object[]).Consultez DbRawSqlQuery pour une version non générique de cette classe. |
![]() |
DbReferenceEntry | Version non générique de la classe DbReferenceEntry<TEntity, TProperty>. |
![]() |
DbReferenceEntry<TEntity, TProperty> | Les instances de cette classe sont retournées à partir de la méthode Reference de DbEntityEntry<TEntity> et autorisent des opérations telles que le chargement sur les propriétés de navigation de référence d'une entité. |
![]() |
DbSqlQuery | Représente une requête SQL pour les entités créées à partir d'un DbContext qui est exécutée à l'aide de la connexion à partir ce contexte.Les instances de cette classe sont obtenues de l'instance DbSet pour le type d'entité.La requête n'est pas exécutée lorsque cet objet est créé ; elle est exécutée chaque fois qu'elle est énumérée, par exemple en utilisant l'instruction « foreach ».Les requêtes SQL pour les non-entités sont créées à l'aide de SqlQuery(Type, String, Object[]).Consultez DbSqlQuery<TEntity> pour une version générique de cette classe. |
![]() |
DbSqlQuery<TEntity> | Représente une requête SQL pour les entités créées à partir d'un DbContext qui est exécutée à l'aide de la connexion à partir ce contexte.Les instances de cette classe sont obtenues de l'instance DbSet<TEntity> pour le type d'entité.La requête n'est pas exécutée lorsque cet objet est créé ; elle est exécutée chaque fois qu'elle est énumérée, par exemple en utilisant l'instruction « foreach ».Les requêtes SQL pour les non-entités sont créées à l'aide de SqlQuery<TElement>(String, Object[]).Consultez DbSqlQuery pour une version non générique de cette classe. |
![]() |
DbUpdateConcurrencyException | Exception levée par DbContext lorsqu'il est attendu que SaveChanges pour une entité entraîne la mise à jour d'une base de données, mais en réalité, aucune ligne dans la base de données n'est affectée.Cela indique habituellement que la base de données a été mise à jour simultanément et qu'un jeton de concurrence supposé correspondre n'a pas correspondu réellement.Notez que les entrées d'état référencées par cette exception ne sont pas sérialisées pour des raisons de sécurité et l'accès aux entrées d'état après la sérialisation retourne une valeur null. |
![]() |
DbUpdateException | Exception levée par DbContext lorsque l'enregistrement des modifications dans la base de données échoue.Notez que les entrées d'état référencées par cette exception ne sont pas sérialisées pour des raisons de sécurité et l'accès aux entrées d'état après la sérialisation retourne une valeur null. |
![]() |
DefaultExecutionStrategy | Représente le IDbExecutionStrategy par défaut qui n'effectue pas de nouvelles tentatives en cas d'échec. |
![]() |
DefaultManifestTokenResolver | Représente une implémentation par défaut de IManifestTokenResolver qui utilise le fournisseur sous-jacent pour obtenir le jeton de manifeste.Notez que pour éviter plusieurs requêtes, cette implémentation utilise la mise en cache selon le type réel d'instance DbConnection, de la propriété DataSource et de la propriété Database. |
![]() |
EdmMetadata | Obsolète. Représente une entité utilisée pour stocker des métadonnées sur un EDM dans la base de données. |
![]() |
EdmxWriter | Contient les méthodes utilisées pour accéder à l'Entity Data Model créé par Code First dans le formulaire EDMX.Ces méthodes sont généralement utilisées pour le débogage, lorsqu'il est nécessaire de regarder le modèle que Code First créé en interne. |
![]() |
ExecutionStrategyKey | Clé utilisée pour résoudre Func<TResult>.Elle se compose du nom invariant de fournisseur ADO.NET et du nom du serveur de base de données spécifié dans la chaîne de connexion. |
![]() |
IncludeMetadataConvention | Obsolète. Cette convention DbModelBuilder fait en sorte que DbModelBuilder inclue les métadonnées sur le modèle lorsqu'il génère le modèle.Lorsque DbContext crée un modèle par convention, il ajoutera cette convention à la liste de celles utilisées par le DbModelBuilder.Cela entraînera l'écriture des métadonnées du modèle dans la base de données si le DbContext est utilisé pour créer la base de données.Cela peut ensuite être utilisé pour vérifier rapidement si le modèle a changé depuis la dernière fois qu'il a été utilisé sur la base de données.Cette convention peut être supprimée des conventions DbModelBuilder en substituant la méthode OnModelCreating sur une classe DbContext dérivée. |
![]() |
LocalDbConnectionFactory | Les instances de cette classe sont utilisées pour créer des objets DbConnection pour SQL Server LocalDb en fonction d'un nom de base de données spécifique ou d'une chaîne de connexion. |
![]() |
ModelContainerConvention | Cette convention DbModelBuilder utilise le nom de la classe DbContext dérivée en tant que conteneur pour le modèle conceptuel construit par Code First. |
![]() |
ModelNamespaceConvention | Cette convention DbModelBuilder utilise l'espace de noms de la classe DbContext dérivée en tant qu'espace de noms du modèle conceptuel construit par Code First. |
![]() |
ObjectReferenceEqualityComparer | Compare des objets à l'aide de l'égalité de référence. |
![]() |
ReplacementDbQueryWrapper<TElement> | Les instances de cette classe sont utilisées en interne pour créer des expressions constantes pour ObjectQuery<T> qui sont insérées dans l'arborescence d'expressions pour remplacer des références à DbQuery<TResult> et DbQuery. |
![]() |
RetryLimitExceededException | Exception levée lorsque l'action échoue après le nombre de nouvelles tentatives configuré. |
![]() |
SqlCeConnectionFactory | Les instances de cette classe sont utilisées pour créer des objets DbConnection pour SQL Server Compact Edition en fonction d'un nom de base de données donné ou d'une chaîne de connexion. |
![]() |
SqlConnectionFactory | Les instances de cette classe sont utilisées pour créer des objets DbConnection pour SQL Server en fonction d'un nom de base de données spécifique ou d'une chaîne de connexion.Par défaut, la connexion est établie avec « .\SQLEXPRESS ».Cela peut être modifié à l'aide de la chaîne de connexion de base lors de la construction d'une instance de fabrique. |
![]() |
SuppressDbSetInitializationAttribute | Cet attribut peut être appliqué à une classe DbContext dérivée entière ou aux propriétés DbSet<TEntity> ou IDbSet<TEntity> individuelles sur cette classe.S'il est appliqué, toutes les propriétés DbSet<TEntity> ou IDbSet<TEntity> découvertes sont toujours incluses dans le modèle, mais ne sont pas initialisées automatiquement. |
![]() |
TableExistenceChecker | Implémenté par les fournisseurs Entity Framework et utilisé pour vérifier si des tables existent dans une base de données spécifique.Les initialiseurs de base de données s'en servent pour déterminer s'il faut considérer une base de données existante comme étant vide pour imposer la création de tables. |
![]() |
TransactionContext | Cette classe est utilisée par CommitFailureHandler pour lire et écrire des informations de suivi de transaction depuis la base de données.Pour personnaliser la définition de la table de transactions, vous pouvez dériver de cette classe et remplacer OnModelCreating(DbModelBuilder).Les classes dérivées peuvent être inscrites avec DbConfiguration. |
![]() |
TransactionHandler | Représente la classe de base des intercepteurs qui gèrent les opérations de transaction.Les classes dérivées peuvent être inscrites à l'aide de SetDefaultTransactionHandler(Func<TransactionHandler>) ou de SetTransactionHandler(String, Func<TransactionHandler>, String). |
![]() |
TransactionRow | Représente une transaction. |
![]() |
UnintentionalCodeFirstException | Exception levée lorsqu'un contexte est généré à partir des modèles DbContext en mode Database First ou Model First, puis utilisé en mode Code First. |
Interfaces
Interface | Description | |
---|---|---|
![]() |
IDbAsyncEnumerable | Version asynchrone de l'interface IEnumerable qui permet l'extraction asynchrone des éléments.Cette interface est utilisée pour interagir avec des requêtes Entity Framework et ne doit pas être implémentée par des classes personnalisées. |
![]() |
IDbAsyncEnumerable<T> | Version asynchrone de l'interface IEnumerable<T> qui permet l'extraction asynchrone des éléments de la séquence énumérable.Cette interface est utilisée pour interagir avec des requêtes Entity Framework et ne doit pas être implémentée par des classes personnalisées. |
![]() |
IDbAsyncEnumerator | Version asynchrone de l'interface IEnumerator qui permet l'extraction asynchrone des éléments.Cette interface est utilisée pour interagir avec des requêtes Entity Framework et ne doit pas être implémentée par des classes personnalisées. |
![]() |
IDbAsyncEnumerator<T> | Version asynchrone de l'interface IEnumerator<T> qui permet l'extraction asynchrone des éléments.Cette interface est utilisée pour interagir avec des requêtes Entity Framework et ne doit pas être implémentée par des classes personnalisées. |
![]() |
IDbAsyncQueryProvider | Définit des méthodes destinées à créer et exécuter de façon asynchrone des requêtes décrites par un objet IQueryable.Cette interface est utilisée pour interagir avec des requêtes Entity Framework et ne doit pas être implémentée par des classes personnalisées. |
![]() |
IDbConnectionFactory | Les implémentations de cette interface sont utilisées pour créer des objets DbConnection pour un type de serveur de base de données selon un nom de la base de données spécifique.Une instance est définie sur la classe Database pour que tous les objets DbContext qui doivent être créés sans informations de connexion ou juste un nom de base de données ou chaîne de connexion, utilisent un certain type de serveur de base de données.Deux implémentations de cette interface sont fournies : SqlConnectionFactory utilisé pour créer des connexions à Microsoft SQL Server, y compris les éditions EXPRESS.SqlCeConnectionFactory utilisé pour créer des connexions à Microsoft SQL Server Compact Edition.D'autres implémentations pour d'autres serveurs de bases de données peuvent être ajoutées au besoin.Notez que les implémentations doivent être thread-safe ou immuables puisqu'elles sont accessibles en même temps par plusieurs threads. |
![]() |
IDbContextFactory<TContext> | Fabrique permettant de créer des instances dérivées de DbContext.Implémentez cette interface pour activer les services au moment de la conception des types de contexte qui n'ont pas de constructeur public par défaut.Au moment de la conception, des instances DbContext dérivées peuvent être créées pour activer des expériences de conception spécifiques, telles que le rendu des modèles et la génération du DDL, etc.Pour activer l'instantiation au moment de la conception des types DbContext dérivés qui n'ont pas de constructeur public par défaut, implémentez cette interface.Les services au moment de la conception détectent automatiquement les implémentations de cette interface qui se trouvent dans le même assembly que le type de DbContext dérivé. |
![]() |
IDbExecutionStrategy | Stratégie utilisée pour exécuter une commande ou une requête sur la base de données, éventuellement avec une logique de nouvelle tentative en cas d'échec. |
![]() |
IDbModelCacheKey | Représente une valeur de clé qui identifie de manière unique un modèle Entity Framework qui a été chargé en mémoire. |
![]() |
IDbModelCacheKeyProvider | Implémente cette interface sur votre contexte afin d'utiliser la logique personnalisée pour calculer la clé utilisée pour rechercher un modèle déjà créé dans le cache.Cette interface vous permet de disposer d'un type de context unique qui peut être utilisé avec différents modèles dans le même AppDomain, ou de plusieurs types de contexte qui utilisent le même modèle. |
![]() |
IDbProviderFactoryResolver | Service pour obtenir le DbProviderFactory approprié d'un DbConnection donné. |
![]() |
IManifestTokenResolver | Service pour obtenir un jeton de manifeste du fournisseur pour une connexion donnée.La classe DefaultManifestTokenResolver est utilisée par défaut et utilise le fournisseur sous-jacent pour obtenir le jeton, ce qui implique souvent l'ouverture de la connexion.Une implémentation différente peut être utilisée à la place en ajoutant un IDbDependencyResolver à DbConfiguration qui peut utiliser toutes les informations de la connexion pour obtenir le jeton.Par exemple, si la connexion est connue pour pointer vers une base de données SQL Server 2008, « 2008 » peut être retourné sans ouvrir la connexion. |
![]() |
IMetadataAnnotationSerializer | Implémentez cette interface pour permettre aux annotations personnalisées représentées par les instances MetadataProperty d'être sérialisées depuis et vers EDMX XML.Habituellement, une instance du sérialiseur est définie à l'aide de la méthode SetMetadataAnnotationSerializer(String, Func<IMetadataAnnotationSerializer>). |
![]() |
IObjectContextAdapter | Interface implémentée par les objets qui peuvent fournir une instance ObjectContext.La classe DbContext implémente cette interface pour fournir l'accès à l'ObjectContext sous-jacent. |
![]() |
IProviderInvariantName | Utilisé par IDbDependencyResolver et DbConfiguration pour résoudre un nom invariant de fournisseur à partir d'un DbProviderFactory. |
Énumérations
Énumération | Description | |
---|---|---|
![]() |
DbConnectionStringOrigin | Décrit l'origine de la chaîne de connexion de base de données associée à un objet DbContext. |