EntityEntry Klasse

Definition

Ermöglicht den Zugriff auf Änderungs nach Verfolgungs Informationen und-Vorgänge für eine bestimmte Entität.

Instanzen dieser Klasse werden von Methoden zurückgegeben, wenn die ChangeTracker API verwendet wird, und Sie ist nicht darauf ausgelegt, direkt im Anwendungscode erstellt zu werden.

[System.Diagnostics.DebuggerDisplay("{_internalEntityEntry,nq}")]
public class EntityEntry : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<Microsoft.EntityFrameworkCore.ChangeTracking.Internal.InternalEntityEntry>
[System.Diagnostics.DebuggerDisplay("{InternalEntry,nq}")]
public class EntityEntry : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<Microsoft.EntityFrameworkCore.ChangeTracking.Internal.InternalEntityEntry>
[<System.Diagnostics.DebuggerDisplay("{_internalEntityEntry,nq}")>]
type EntityEntry = class
    interface IInfrastructure<InternalEntityEntry>
[<System.Diagnostics.DebuggerDisplay("{InternalEntry,nq}")>]
type EntityEntry = class
    interface IInfrastructure<InternalEntityEntry>
Public Class EntityEntry
Implements IInfrastructure(Of InternalEntityEntry)
Vererbung
EntityEntry
Abgeleitet
Attribute
Implementiert
IInfrastructure<Microsoft.EntityFrameworkCore.ChangeTracking.Internal.InternalEntityEntry>

Konstruktoren

EntityEntry(InternalEntityEntry)

Dies ist eine interne API, die die Entity Framework Core-Infrastruktur unterstützt und nicht denselben Kompatibilitäts Standards wie öffentliche APIs unterliegt. Sie kann in einem Release ohne vorherige Ankündigung geändert oder entfernt werden. Sie sollten Sie nur mit äußerster Vorsicht direkt in Ihrem Code verwenden. Wenn Sie wissen, dass dies beim Aktualisieren auf eine neue Entity Framework Core Version zu Anwendungsfehlern führen kann.

Eigenschaften

Collections

Ermöglicht den Zugriff auf Änderungs nach Verfolgungs Informationen und das Laden von Informationen für alle Sammlungs Navigations Eigenschaften dieser Entität.

Context

Ruft den Kontext ab, der die Entität nachverfolgt.

CurrentValues

Ruft die aktuellen Eigenschaftswerte für diese Entität ab.

DebugView

Erweitern Sie diese Eigenschaft im Debugger für eine lesbare Sicht des Eintrags.

Warnung: verlassen Sie sich nicht auf das Format der Debugzeichenfolgen. Sie sind nur für das Debuggen konzipiert und können sich beliebig zwischen den Releases ändern.

Entity

Ruft die Entität ab, die von diesem Eintrag nachverfolgt wird.

InternalEntry

Dies ist eine interne API, die die Entity Framework Core-Infrastruktur unterstützt und nicht denselben Kompatibilitäts Standards wie öffentliche APIs unterliegt. Sie kann in einem Release ohne vorherige Ankündigung geändert oder entfernt werden. Sie sollten Sie nur mit äußerster Vorsicht direkt in Ihrem Code verwenden. Wenn Sie wissen, dass dies beim Aktualisieren auf eine neue Entity Framework Core Version zu Anwendungsfehlern führen kann.

IsKeySet

Ruft einen Wert ab, der angibt, ob den Schlüsselwerten dieser Entität ein Wert zugewiesen wurde.

Für Schlüssel mit vom Speicher generierten Eigenschaften (z. b. die Zuordnung zu Identitäts Spalten) lautet der Rückgabewert FALSE, wenn eine der vom Speicher generierten Eigenschaften über den CLR-Standardwert verfügt.

Bei Schlüsseln ohne vom Speicher generierte Eigenschaften ist der Rückgabewert immer true, da jeder Wert als gültiger Schlüsselwert angesehen wird.

Members

Ermöglicht den Zugriff auf Änderungs nach Verfolgungs Informationen und-Vorgänge für alle Eigenschaften und Navigations Eigenschaften dieser Entität.

Metadata

Ruft die Metadaten über die Form der Entität, die Beziehungen zu anderen Entitäten und deren Zuordnung zur Datenbank ab.

Navigations

Ermöglicht den Zugriff auf Änderungs nach Verfolgungs Informationen und-Vorgänge für alle Navigations Eigenschaften dieser Entität.

OriginalValues

Ruft die ursprünglichen Eigenschaftswerte für diese Entität ab. Die ursprünglichen Werte sind die Eigenschaftswerte, die beim Abrufen der Entität aus der Datenbank aufgetreten sind.

Beachten Sie, dass standardmäßig die aktuellen Eigenschaftswerte dieser Entität verwendet werden, wenn keine echten ursprünglichen Eigenschaftswerte verfügbar sind (z. b. wenn die Entität noch nicht in der Datenbank persistent gespeichert wurde).

Properties

Ermöglicht den Zugriff auf Änderungs nach Verfolgungs Informationen und-Vorgänge für alle Eigenschaften dieser Entität.

References

Ermöglicht den Zugriff auf Änderungs nach Verfolgungs Informationen und das Laden von Informationen für alle Verweis-Navigations Eigenschaften (d.h. nicht Auflistungen) dieser Entität.

State

Ruft den Zustand ab, in dem diese Entität nachverfolgt wird, oder legt diesen fest.

Mit dieser Methode wird nur der Zustand der einzelnen Entität festgelegt, die durch diesen Eintrag dargestellt wird. Der Status von anderen Entitäten, die von diesem Dienst erreichbar sind, wird nicht geändert.

Beim Festlegen des Zustands wird die Entität immer im angegebenen Zustand angezeigt. Wenn Sie z. b. den Zustand ändern, Deleted wird die Entität unabhängig vom aktuellen Zustand zum Löschen markiert. Dies unterscheidet sich von dem Aufruf Remove(TEntity) von, bei dem die Entität getrennt wird (anstatt zum Löschen markiert), wenn Sie sich im- Added Zustand befindet.

Methoden

Collection(String)

Bietet Zugriff auf die Änderungs Nachverfolgung und das Laden von Informationen für eine Auflistungs Navigations Eigenschaft, die diese Entität einer Auflistung von anderen Entitäten zuordnet.

DetectChanges()

Scannt diese Entitäts Instanz, um Änderungen zu erkennen, die an den Instanzdaten vorgenommen wurden. DetectChanges() wird normalerweise automatisch vom Kontext aufgerufen, um aktuelle Informationen zu einer einzelnen Entität zu erhalten, bevor Informationen zur Änderungs Nachverfolgung zurückgegeben werden. Sie müssen diese Methode in der Regel nur dann aufzurufen, wenn Sie deaktiviert haben AutoDetectChangesEnabled .

GetDatabaseValues()

Fragt Kopien der gegenwärtig in der Datenbank vorhandenen Werte der nachverfolgten Entität aus der Datenbank ab. Wenn die Entität nicht in der Datenbank gefunden wird, wird NULL zurückgegeben.

Beachten Sie, dass durch das Ändern der Werte im zurückgegebenen Wörterbuch die Werte in der Datenbank nicht aktualisiert werden.

GetDatabaseValuesAsync(CancellationToken)

Fragt Kopien der gegenwärtig in der Datenbank vorhandenen Werte der nachverfolgten Entität aus der Datenbank ab. Wenn die Entität nicht in der Datenbank gefunden wird, wird NULL zurückgegeben.

Beachten Sie, dass durch das Ändern der Werte im zurückgegebenen Wörterbuch die Werte in der Datenbank nicht aktualisiert werden.

Mehrere aktive Vorgänge in derselben Kontext Instanz werden nicht unterstützt. Verwenden Sie "warten", um sicherzustellen, dass alle asynchronen Vorgänge abgeschlossen sind, bevor Sie eine andere Methode in diesem Kontext aufrufen.

Member(String)

Ermöglicht den Zugriff auf Änderungs nach Verfolgungs Informationen und-Vorgänge für eine bestimmte Eigenschaft oder Navigations Eigenschaft dieser Entität.

Navigation(String)

Ermöglicht den Zugriff auf Änderungs nach Verfolgungs Informationen und-Vorgänge für eine bestimmte Navigations Eigenschaft dieser Entität.

Property(String)

Ermöglicht den Zugriff auf Änderungs nach Verfolgungs Informationen und-Vorgänge für eine bestimmte Eigenschaft dieser Entität.

Reference(String)

Bietet Zugriff auf die Änderungs Nachverfolgung und das Laden von Informationen für eine Verweis-(d.h. nicht auflistende) Navigations Eigenschaft, die diese Entität einer anderen Entität zuordnet.

Reload()

Lädt die Entität erneut aus der Datenbank und überschreibt alle Eigenschaftswerte mit Werten aus der Datenbank.

Die Entität befindet sich Unchanged nach dem Aufruf dieser Methode im Zustand, es sei denn, die Entität ist in der Datenbank nicht vorhanden. in diesem Fall wird die Entität verwendet Detached . Zum Schluss ist das Aufrufen von "Neuladen" für eine Added Entität, die in der Datenbank nicht vorhanden ist, ein No-op. Beachten Sie jedoch, dass für eine hinzugefügte Entität möglicherweise noch nicht der permanente Schlüsselwert erstellt wurde.

ReloadAsync(CancellationToken)

Lädt die Entität erneut aus der Datenbank und überschreibt alle Eigenschaftswerte mit Werten aus der Datenbank.

Die Entität befindet sich Unchanged nach dem Aufruf dieser Methode im Zustand, es sei denn, die Entität ist in der Datenbank nicht vorhanden. in diesem Fall wird die Entität verwendet Detached . Zum Schluss ist das Aufrufen von "Neuladen" für eine Added Entität, die in der Datenbank nicht vorhanden ist, ein No-op. Beachten Sie jedoch, dass für eine hinzugefügte Entität möglicherweise noch nicht der permanente Schlüsselwert erstellt wurde.

Explizite Schnittstellenimplementierungen

IInfrastructure<InternalEntityEntry>.Instance

Dies ist eine interne API, die die Entity Framework Core-Infrastruktur unterstützt und nicht denselben Kompatibilitäts Standards wie öffentliche APIs unterliegt. Sie kann in einem Release ohne vorherige Ankündigung geändert oder entfernt werden. Sie sollten Sie nur mit äußerster Vorsicht direkt in Ihrem Code verwenden. Wenn Sie wissen, dass dies beim Aktualisieren auf eine neue Entity Framework Core Version zu Anwendungsfehlern führen kann.

Erweiterungsmethoden

GetInfrastructure<T>(IInfrastructure<T>)

Ruft den Wert einer Eigenschaft ab, die mit ausgeblendet wird IInfrastructure<T> .

Diese Methode wird in der Regel von Datenbankanbietern (und anderen Erweiterungen) verwendet. Sie wird in der Regel nicht im Anwendungscode verwendet.

IInfrastructure<T> wird verwendet, um Eigenschaften auszublenden, die nicht für die Verwendung im Anwendungscode vorgesehen sind, aber in von Datenbankanbietern geschriebenen Erweiterungs Methoden usw. verwendet werden können.

Gilt für