System.Data.Entity.Infrastructure Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Klassen
| Name | Beschreibung |
|---|---|
| CommitFailedException |
Wird ausgelöst, wenn ein Fehler auftritt, der ein Commit für ein DbTransaction. |
| CommitFailureHandler |
Ein Transaktionshandler, der die ordnungsgemäße Wiederherstellung von Verbindungsfehlern während des Transaktions-Commits ermöglicht, indem Transaktionsablaufverfolgungsinformationen in der Datenbank gespeichert werden. Sie muss mithilfe SetDefaultTransactionHandler(Func<TransactionHandler>)von . |
| DbChangeTracker |
Wird von der ChangeTracker-Methode zurückgegeben, um DbContext Zugriff auf Features des Kontexts bereitzustellen, die mit der Änderungsnachverfolgung von Entitäten zusammenhängen. |
| DbCollectionEntry |
Eine nicht generische Version der DbCollectionEntry<TEntity,TElement> Klasse. |
| DbCollectionEntry<TEntity,TElement> |
Instanzen dieser Klasse werden von der Collection-Methode DbEntityEntry<TEntity> zurückgegeben und ermöglichen Vorgängen, z. B. das Laden für die Navigationseigenschaften der Auflistung einer Entität. |
| DbCompiledModel |
Eine unveränderliche Darstellung eines Entitätsdatenmodells (Entity Data Model, EDM), das zum Erstellen eines ObjectContext Oder übergeben werden kann, an den Konstruktor einer .DbContext Für eine höhere Leistung sollten Instanzen dieses Typs zwischengespeichert und zum Erstellen von Kontexten wiederverwendet werden. |
| DbComplexPropertyEntry |
Eine nicht generische Version der DbComplexPropertyEntry<TEntity,TComplexProperty> Klasse. |
| DbComplexPropertyEntry<TEntity,TComplexProperty> |
Instanzen dieser Klasse werden von der ComplexProperty-Methode DbEntityEntry<TEntity> zurückgegeben und ermöglichen den Zugriff auf den Status einer komplexen Eigenschaft. |
| DbConnectionInfo |
Stellt Informationen zu einer Datenbankverbindung dar. |
| DbContextConfiguration |
Wird von der Configuration-Methode DbContext zurückgegeben, um Zugriff auf Konfigurationsoptionen für den Kontext bereitzustellen. |
| DbContextInfo |
Stellt Laufzeitinformationen zu einem bestimmten DbContext Typ bereit. |
| DbEntityEntry |
Eine nicht generische Version der DbEntityEntry<TEntity> Klasse. |
| DbEntityEntry<TEntity> |
Instanzen dieser Klasse bieten Zugriff auf Informationen über und kontrolle von Entitäten, die von der DbContext. Verwenden Sie die Methoden "Entity" oder "Entities" des Kontexts, um Objekte dieses Typs abzurufen. |
| DbExecutionStrategy |
Stellt die Basisimplementierung des Wiederholungsmechanismus für unzuverlässige Vorgänge und vorübergehende Bedingungen bereit, die exponentielle Verzögerungen zwischen Wiederholungen verwenden. |
| DbMemberEntry |
Dies ist eine abstrakte Basisklasse, die verwendet wird, um eine skalare oder komplexe Eigenschaft oder eine Navigationseigenschaft einer Entität darzustellen. Skalare und komplexe Eigenschaften verwenden die abgeleitete Klasse DbPropertyEntry, Referenznavigationseigenschaften verwenden die abgeleitete Klasse DbReferenceEntry, und Die Sammlungsnavigationseigenschaften verwenden die abgeleitete Klasse DbCollectionEntry. |
| DbMemberEntry<TEntity,TProperty> |
Dies ist eine abstrakte Basisklasse, die verwendet wird, um eine skalare oder komplexe Eigenschaft oder eine Navigationseigenschaft einer Entität darzustellen. Skalare und komplexe Eigenschaften verwenden die abgeleitete Klasse DbPropertyEntry<TEntity,TProperty>, Referenznavigationseigenschaften verwenden die abgeleitete Klasse DbReferenceEntry<TEntity,TProperty>, und Die Sammlungsnavigationseigenschaften verwenden die abgeleitete Klasse DbCollectionEntry<TEntity,TElement>. |
| DbModel |
Represents an Entity Data Model (EDM) created by the DbModelBuilder. Die Compile-Methode kann verwendet werden, um von dieser EDM-Darstellung zu einer DbCompiledModel kompilierten Momentaufnahme des Modells zu wechseln, die zum Zwischenspeichern und Erstellen von DbContext oder ObjectContext Instanzen geeignet ist. |
| DbModelStore |
Basisklasse für den permanenten Modellcache. |
| DbPropertyEntry |
Eine nicht generische Version der DbPropertyEntry<TEntity,TProperty> Klasse. |
| DbPropertyEntry<TEntity,TProperty> |
Instanzen dieser Klasse werden von der Property-Methode DbEntityEntry<TEntity> zurückgegeben und ermöglichen den Zugriff auf den Status der skalaren oder komplexen Eigenschaft. |
| DbPropertyValues |
Eine Auflistung aller Eigenschaften für eine zugrunde liegende Entität oder ein komplexes Objekt. |
| DbProviderInfo |
Gruppiert ein Zeichenfolgenpaar, das einen Anbieter und eine Serverversion zusammen in ein einzelnes Objekt identifiziert. |
| DbQuery |
Stellt eine nicht generische LINQ to Entities-Abfrage für einen DbContext dar. |
| DbQuery<TResult> |
Stellt eine LINQ to Entities-Abfrage für einen DbContext dar. |
| DbRawSqlQuery |
Stellt eine SQL-Abfrage für Nichtentitäten dar, die anhand DbContext der Verbindung aus diesem Kontext erstellt und ausgeführt wird. Instanzen dieser Klasse werden aus der Database Instanz abgerufen. Die Abfrage wird nicht ausgeführt, wenn dieses Objekt erstellt wird; sie wird jedes Mal ausgeführt, wenn sie aufgezählt wird, z. B. mithilfe von Foreach. SQL-Abfragen für Entitäten werden mithilfe von SqlQuery(String, Object[]). Eine generische Version dieser Klasse finden Sie unter.See DbRawSqlQuery<TElement> for a generic version of this class. |
| DbRawSqlQuery<TElement> |
Stellt eine SQL-Abfrage für Nichtentitäten dar, die anhand DbContext der Verbindung aus diesem Kontext erstellt und ausgeführt wird.
Instanzen dieser Klasse werden aus der Database Instanz abgerufen.
Die Abfrage wird nicht ausgeführt, wenn dieses Objekt erstellt wird; sie wird jedes Mal ausgeführt, wenn sie aufgezählt wird, z. B. mithilfe von |
| DbReferenceEntry |
Eine nicht generische Version der DbReferenceEntry<TEntity,TProperty> Klasse. |
| DbReferenceEntry<TEntity,TProperty> |
Instanzen dieser Klasse werden von der Reference-Methode DbEntityEntry<TEntity> zurückgegeben und ermöglichen Vorgängen, z. B. das Laden für die Referenznavigationseigenschaften einer Entität. |
| DbSqlQuery |
Stellt eine SQL-Abfrage für Entitäten dar, die anhand der DbContext Verbindung aus diesem Kontext erstellt und ausgeführt werden. Instanzen dieser Klasse werden aus der DbSet Instanz für den Entitätstyp abgerufen. Die Abfrage wird nicht ausgeführt, wenn dieses Objekt erstellt wird; sie wird jedes Mal ausgeführt, wenn sie aufgezählt wird, z. B. mithilfe von Foreach. SQL-Abfragen für Nichtentitäten werden mithilfe von SqlQuery(Type, String, Object[]). Eine generische Version dieser Klasse finden Sie unter.See DbSqlQuery<TEntity> for a generic version of this class. |
| DbSqlQuery<TEntity> |
Stellt eine SQL-Abfrage für Entitäten dar, die anhand der DbContext Verbindung aus diesem Kontext erstellt und ausgeführt werden. Instanzen dieser Klasse werden aus der DbSet<TEntity> Instanz für den Entitätstyp abgerufen. Die Abfrage wird nicht ausgeführt, wenn dieses Objekt erstellt wird; sie wird jedes Mal ausgeführt, wenn sie aufgezählt wird, z. B. mithilfe von Foreach. SQL-Abfragen für Nichtentitäten werden mithilfe von SqlQuery<TElement>(String, Object[]). Eine nicht generische Version dieser Klasse finden Sie unter.See DbSqlQuery for a non-generic version of this class. |
| DbUpdateConcurrencyException |
Ausnahme ausgelöst, wenn DbContext erwartet wurde, dass SaveChanges für eine Entität zu einer Datenbankaktualisierung führen würde, aber tatsächlich wurden keine Zeilen in der Datenbank betroffen. Dies weist in der Regel darauf hin, dass die Datenbank gleichzeitig aktualisiert wurde, sodass ein Parallelitätstoken, das erwartet wurde, nicht tatsächlich übereinstimmen. Beachten Sie, dass Zustandseinträge, auf die von dieser Ausnahme verwiesen wird, aufgrund von Sicherheit nicht serialisiert werden, und der Zugriff auf die Statuseinträge nach der Serialisierung gibt NULL zurück. |
| DbUpdateException |
Ausnahme ausgelöst, wenn DbContext das Speichern von Änderungen an der Datenbank fehlschlägt. Beachten Sie, dass Zustandseinträge, auf die von dieser Ausnahme verwiesen wird, aufgrund von Sicherheit nicht serialisiert werden, und der Zugriff auf die Statuseinträge nach der Serialisierung gibt NULL zurück. |
| DefaultDbModelStore |
Lädt Modelle von/in edmx-Dateien an einem angegebenen Speicherort, oder speichert sie. |
| DefaultExecutionStrategy |
Ein IDbExecutionStrategy Vorgang, der nicht wiederholt wird, wenn er fehlschlägt. |
| DefaultManifestTokenResolver |
Eine Standardimplementierung, die IManifestTokenResolver den zugrunde liegenden Anbieter verwendet, um das Manifesttoken abzurufen. Beachten Sie, dass diese Implementierung, die auf dem tatsächlichen Instanztyp DbConnection , der DataSource Eigenschaft und der Database Eigenschaft basiert, verwendet, um mehrere Abfragen zu vermeiden. |
| EdmMetadata |
Stellt eine Entität dar, die zum Speichern von Metadaten zu einem EDM in der Datenbank verwendet wird. |
| EdmxReader |
Hilfsklasse zum Lesen eines Metadatenmodells aus .edmx. |
| EdmxWriter |
Enthält Methoden, die für den Zugriff auf das von Code First im EDMX-Formular erstellte Entitätsdatenmodell verwendet werden. Diese Methoden werden in der Regel für das Debuggen verwendet, wenn es erforderlich ist, das Modell zu betrachten, das Code First intern erstellt. |
| ExecutionStrategyKey |
Ein Schlüssel, der zum Auflösen Func<TResult>verwendet wird. Er besteht aus dem in der Verbindungszeichenfolge angegebenen ADO.NET Anbieternamen und dem Datenbankservernamen. |
| IncludeMetadataConvention |
Diese DbModelBuilder Konvention bewirkt, dass DbModelBuilder Metadaten zum Modell enthält, wenn es das Modell erstellt. Wenn DbContext sie ein Modell nach Konvention erstellt, wird diese Konvention der Liste der vom DbModelBuilder verwendeten Konventionen hinzugefügt. Dies führt dann dazu, dass Modellmetadaten in die Datenbank geschrieben werden, wenn der DbContext zum Erstellen der Datenbank verwendet wird. Dies kann dann als schnelle Überprüfung verwendet werden, um festzustellen, ob sich das Modell seit der letzten Verwendung für die Datenbank geändert hat. Diese Konvention kann aus den DbModelBuilder Konventionen entfernt werden, indem die OnModelCreating-Methode für eine abgeleitete DbContext-Klasse überschrieben wird. |
| LocalDbConnectionFactory |
Instanzen dieser Klasse werden verwendet, um DbConnection-Objekte für SQL Server LocalDb basierend auf einem bestimmten Datenbanknamen oder Verbindungszeichenfolge zu erstellen. |
| ModelContainerConvention |
Diese DbModelBuilder Konvention verwendet den Namen der abgeleiteten DbContext Klasse als Container für das konzeptuelle Modell, das von Code First erstellt wurde. |
| ModelNamespaceConvention |
Diese DbModelBuilder Konvention verwendet den Namespace der abgeleiteten DbContext Klasse als Namespace des konzeptuellen Modells, das von Code First erstellt wurde. |
| ObjectReferenceEqualityComparer |
Vergleicht Objekte mithilfe der Referenzgleichheit. |
| ReplacementDbQueryWrapper<TElement> |
Instanzen dieser Klasse werden intern verwendet, um Konstantenausdrücke zu erstellen, für ObjectQuery<T> die in die Ausdrucksstruktur eingefügt werden, um Verweise auf DbQuery<TResult> und DbQuery. |
| RetryLimitExceededException |
Die Ausnahme, die ausgelöst wird, wenn die Aktion erneut fehlgeschlagen ist, nachdem die konfigurierte Anzahl wiederholt wurde. |
| SqlCeConnectionFactory |
Instanzen dieser Klasse werden verwendet, um DbConnection-Objekte für SQL Server Compact Edition basierend auf einem bestimmten Datenbanknamen oder Verbindungszeichenfolge zu erstellen. |
| SqlConnectionFactory |
Instanzen dieser Klasse werden verwendet, um DbConnection-Objekte für SQL Server basierend auf einem bestimmten Datenbanknamen oder Verbindungszeichenfolge zu erstellen. Standardmäßig wird die Verbindung mit '.\SQLEXPRESS' hergestellt. Dies kann durch Ändern der Basis-Verbindungszeichenfolge beim Erstellen einer Factoryinstanz geändert werden. |
| SuppressDbSetInitializationAttribute |
Dieses Attribut kann entweder auf eine gesamte abgeleitete DbContext Klasse oder auf einzelne DbSet<TEntity> oder IDbSet<TEntity> Eigenschaften für diese Klasse angewendet werden. Wenn ermittelte DbSet<TEntity> oder IDbSet<TEntity> Eigenschaften angewendet werden, werden sie weiterhin im Modell enthalten, werden aber nicht automatisch initialisiert. |
| TableExistenceChecker |
Implementiert von Entity Framework-Anbietern und verwendet, um zu überprüfen, ob Tabellen in einer bestimmten Datenbank vorhanden sind. Dies wird von Datenbankinitialisierern verwendet, wenn ermittelt wird, ob eine vorhandene Datenbank als leer behandelt werden soll, sodass Tabellen erstellt werden sollen. |
| TransactionContext |
Diese Klasse wird verwendet CommitFailureHandler , um Transaktionsablaufverfolgungsinformationen aus der Datenbank zu schreiben und zu lesen. Um die Definition der Transaktionstabelle anzupassen, können Sie von dieser Klasse abgeleitet und außer Kraft setzen OnModelCreating(DbModelBuilder). Abgeleitete Klassen können mithilfe von DbConfiguration. |
| TransactionHandler |
Die Basisklasse für Interceptors, die die Transaktionsvorgänge verarbeiten. Abgeleitete Klassen können mit SetDefaultTransactionHandler(Func<TransactionHandler>) oder SetTransactionHandler(String, Func<TransactionHandler>, String). |
| TransactionRow |
Rrepresents a transaction |
| UnintentionalCodeFirstException |
Wird ausgelöst, wenn ein Kontext aus den DbContext Vorlagen im Modus "Datenbank first" oder "Modell first" generiert wird und dann im Code First-Modus verwendet wird. |
Schnittstellen
| Name | Beschreibung |
|---|---|
| IDbAsyncEnumerable |
Asynchrone Version der Schnittstelle, mit der IEnumerable Elemente asynchron abgerufen werden können. Diese Schnittstelle wird verwendet, um mit Entity Framework-Abfragen zu interagieren und sollte nicht von benutzerdefinierten Klassen implementiert werden. |
| IDbAsyncEnumerable<T> |
Asynchrone Version der IEnumerable<T> Schnittstelle, mit der Elemente der enumerationsfähigen Sequenz asynchron abgerufen werden können. Diese Schnittstelle wird verwendet, um mit Entity Framework-Abfragen zu interagieren und sollte nicht von benutzerdefinierten Klassen implementiert werden. |
| IDbAsyncEnumerator |
Asynchrone Version der Schnittstelle, mit der IEnumerator Elemente asynchron abgerufen werden können. Diese Schnittstelle wird verwendet, um mit Entity Framework-Abfragen zu interagieren und sollte nicht von benutzerdefinierten Klassen implementiert werden. |
| IDbAsyncEnumerator<T> |
Asynchrone Version der Schnittstelle, mit der IEnumerator<T> Elemente asynchron abgerufen werden können. Diese Schnittstelle wird verwendet, um mit Entity Framework-Abfragen zu interagieren und sollte nicht von benutzerdefinierten Klassen implementiert werden. |
| IDbAsyncQueryProvider |
Definiert Methoden zum Erstellen und asynchronen Ausführen von Abfragen, die von einem IQueryable Objekt beschrieben werden. Diese Schnittstelle wird verwendet, um mit Entity Framework-Abfragen zu interagieren und sollte nicht von benutzerdefinierten Klassen implementiert werden. |
| IDbConnectionFactory |
Implementierungen dieser Schnittstelle werden verwendet, um DbConnection-Objekte für einen Datenbankservertyp basierend auf einem bestimmten Datenbanknamen zu erstellen. Eine Instanz wird für die Database Klasse festgelegt, damit alle DbContexts, die ohne Verbindungsinformationen erstellt wurden, oder nur einen Datenbanknamen oder Verbindungszeichenfolge standardmäßig einen bestimmten Datenbankservertyp verwenden. Es werden zwei Implementierungen dieser Schnittstelle bereitgestellt: SqlConnectionFactory Wird verwendet, um Verbindungen mit Microsoft SQL Server zu erstellen, einschließlich EXPRESS-Editionen. SqlCeConnectionFactorywird verwendet, um Verbindungen mit Microsoft SQL Server Compact Editionen zu erstellen. Bei Bedarf können weitere Implementierungen für andere Datenbankserver hinzugefügt werden. Beachten Sie, dass Implementierungen threadsicher oder unveränderlich sein sollten, da sie gleichzeitig von mehreren Threads aufgerufen werden können. |
| IDbContextFactory<TContext> |
Eine Factory zum Erstellen abgeleiteter DbContext Instanzen. Implementieren Sie diese Schnittstelle, um Entwurfszeitdienste für Kontexttypen zu aktivieren, die keinen öffentlichen Standardkonstruktor besitzen. Zur Entwurfszeit können abgeleitete DbContext Instanzen erstellt werden, um spezifische Entwurfszeiterfahrungen wie Modellrendering, DDL-Generierung usw. zu ermöglichen. Um die Entwurfszeitinstanziierung für abgeleitete DbContext Typen zu aktivieren, die keinen öffentlichen Standardkonstruktor besitzen, implementieren Sie diese Schnittstelle. Entwurfszeitdienste ermitteln automatisch Implementierungen dieser Schnittstelle, die sich in derselben Assembly wie der abgeleitete DbContext Typ befinden. |
| IDbExecutionStrategy |
Eine Strategie, die verwendet wird, um einen Befehl oder eine Abfrage für die Datenbank auszuführen, möglicherweise mit Logik zum Wiederholen, wenn ein Fehler auftritt. |
| IDbModelCacheKey |
Stellt einen Schlüsselwert dar, der ein Entity Framework-Modell eindeutig identifiziert, das in den Arbeitsspeicher geladen wurde. |
| IDbModelCacheKeyProvider |
Implementieren Sie diese Schnittstelle in Ihrem Kontext, um benutzerdefinierte Logik zum Berechnen des Schlüssels zu verwenden, der zum Nachschlagen eines bereits erstellten Modells im Cache verwendet wird. Diese Schnittstelle ermöglicht es Ihnen, einen einzelnen Kontexttyp zu haben, der mit verschiedenen Modellen in derselben AppDomain oder mehreren Kontexttypen verwendet werden kann, die dasselbe Modell verwenden. |
| IDbProviderFactoryResolver |
Ein Dienst zum Abrufen der korrekten DbProviderFactory aus einem bestimmten DbConnection. |
| IManifestTokenResolver |
Ein Dienst zum Abrufen eines Anbietermanifesttokens mit einer Verbindung. Die DefaultManifestTokenResolver Klasse wird standardmäßig verwendet und verwendet den zugrunde liegenden Anbieter, um das Token abzurufen, das häufig das Öffnen der Verbindung umfasst. Eine andere Implementierung kann stattdessen verwendet werden, indem sie einen IDbDependencyResolverDbConfiguration hinzufügen, der möglicherweise alle Informationen in der Verbindung verwendet, um das Token zurückzugeben. Wenn die Verbindung beispielsweise bekannt ist, dass sie auf eine SQL Server 2008-Datenbank verweist, kann "2008" zurückgegeben werden, ohne die Verbindung zu öffnen. |
| IMetadataAnnotationSerializer |
Implementieren Sie diese Schnittstelle, damit benutzerdefinierte Anmerkungen, die durch MetadataProperty Instanzen dargestellt werden, in und aus dem EDMX-XML serialisiert werden können. In der Regel wird eine Serialisierungsinstanz mithilfe der SetMetadataAnnotationSerializer(String, Func<IMetadataAnnotationSerializer>) Methode festgelegt. |
| IObjectContextAdapter |
Schnittstelle, die von Objekten implementiert wird, die eine ObjectContext Instanz bereitstellen können. Die DbContext Klasse implementiert diese Schnittstelle, um Zugriff auf den zugrunde liegenden ObjectContext bereitzustellen. |
| IProviderInvariantName |
Wird von IDbDependencyResolver und DbConfiguration beim Auflösen eines anbieterinvarianten Namens von einem DbProviderFactory. |
Enumerationen
| Name | Beschreibung |
|---|---|
| DbConnectionStringOrigin |
Beschreibt den Ursprung der Datenbank Verbindungszeichenfolge zugeordnet einer DbContext. |