ChangeTracker Classe

Définition

Espace de noms:

Microsoft.EntityFrameworkCore.ChangeTracking

Assembly:

Microsoft.EntityFrameworkCore.dll

Package:

Microsoft.EntityFrameworkCore v10.0.0

Source:

ChangeTracker.cs

Fournit l’accès aux informations et opérations de suivi des modifications pour les instances d’entité que le contexte effectue le suivi. Les instances de cette classe sont généralement obtenues ChangeTracker et elles ne sont pas conçues pour être directement construites dans votre code d’application.

[System.Runtime.CompilerServices.Nullable(0)]
public class ChangeTracker : Microsoft.EntityFrameworkCore.Infrastructure.IResettableService

[<System.Runtime.CompilerServices.Nullable(0)>]
type ChangeTracker = class
    interface IResettableService

Public Class ChangeTracker
Implements IResettableService

Héritage

Object

ChangeTracker

Attributs

NullableAttribute

Implémente

IResettableService

Remarques

Pour plus d’informations et d’exemples, consultez le suivi des modifications EF Core .

Constructeurs

Nom

Description

ChangeTracker(DbContext, IStateManager, IChangeDetector, IModel, IEntityEntryGraphIterator)

Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.

Propriétés

Nom	Description
AutoDetectChangesEnabled	Obtient ou définit une valeur indiquant si la DetectChanges() méthode est appelée automatiquement par les méthodes des DbContext classes associées.
CascadeDeleteTiming	Obtient ou définit une valeur indiquant quand une entité dépendante/enfant aura son état défini Deleted une fois que son entité parent/principal a été marquée comme Deleted. La valeur par défaut estImmediate.
Context	Obtient le contexte auquel appartient ce suivi des modifications.
DebugView	Développez cette propriété dans le débogueur pour une vue lisible par l’homme des entités suivies. Avertissement : Ne vous appuyez pas sur le format des chaînes de débogage. Ils sont conçus pour le débogage uniquement et peuvent changer arbitrairement entre les versions. Pour plus d’informations et d’exemples, consultez le suivi des modifications EF Core .
DeleteOrphansTiming	Obtient ou définit une valeur indiquant quand une entité dépendante/enfant aura son état défini sur une fois supprimé d’une entité parent/principale par le biais d’une propriété de navigation ou de clé étrangère définie Deleted sur Null. La valeur par défaut est Immediate.
LazyLoadingEnabled	Obtient ou définit une valeur indiquant si les propriétés de navigation des entités suivies seront chargées lors du premier accès.
QueryTrackingBehavior	Obtient ou définit le comportement de suivi pour les requêtes LINQ exécutées sur le contexte. La désactivation du suivi des modifications est utile pour les scénarios en lecture seule, car elle évite la surcharge de configuration du suivi des modifications pour chaque instance d’entité. Vous ne devez pas désactiver le suivi des modifications si vous souhaitez manipuler des instances d’entité et conserver ces modifications dans la base de données à l’aide SaveChanges()de .

Méthodes

Nom	Description
AcceptAllChanges()	Accepte toutes les modifications apportées aux entités dans le contexte. Il est supposé que les entités suivies représentent l’état actuel de la base de données. Cette méthode est généralement appelée SaveChanges() après l’enregistrement des modifications dans la base de données.
CascadeChanges()	Force la suppression immédiate en cascade d’entités enfants/dépendantes lorsqu’elles sont soit supprimées d’une entité parent/principale requise, soit l’entité parent/principal requise est elle-même supprimée. Voir DeleteBehavior.
Clear()	Arrête le suivi de toutes les entités actuellement suivies.
DetectChanges()	Analyse les instances d’entité suivies pour détecter les modifications apportées aux données d’instance. DetectChanges() est généralement appelé automatiquement par le contexte lorsque up-to-date d’informations est requise (avant SaveChanges() et lors du retour des informations de suivi des modifications). En règle générale, vous n’avez besoin d’appeler cette méthode que si vous avez désactivé AutoDetectChangesEnabled.
Entries()	Retourne une EntityEntry valeur pour chaque entité suivie par le contexte. Les entrées fournissent l’accès aux informations et opérations de suivi des modifications pour chaque entité.
Entries<TEntity>()	Obtient une EntityEntry pour toutes les entités d’un type donné en cours de suivi par le contexte. Les entrées fournissent l’accès aux informations et opérations de suivi des modifications pour chaque entité.
HasChanges()	Vérifie si des entités nouvelles, supprimées ou modifiées sont suivies afin que ces modifications soient envoyées à la base de données si SaveChanges() ou SaveChangesAsync(CancellationToken) est appelée.
TrackGraph(Object, Action<EntityEntryGraphNode>)	Commence le suivi d’une entité et de toutes les entités accessibles en parcourant ses propriétés de navigation. Traversal est récursif, de sorte que les propriétés de navigation de toutes les entités découvertes seront également analysées. L’entité spécifiée callback est appelée pour chaque entité découverte et doit définir le State suivi de chaque entité. Si aucun état n’est défini, l’entité reste sans suivi.
TrackGraph<TState>(Object, TState, Func<EntityEntryGraphNode<TState>,Boolean>)	Commence le suivi d’une entité et de toutes les entités accessibles en parcourant ses propriétés de navigation. Traversal est récursif, de sorte que les propriétés de navigation de toutes les entités découvertes seront également analysées. L’entité spécifiée callback est appelée pour chaque entité découverte et doit définir le State suivi de chaque entité. Si aucun état n’est défini, l’entité reste sans suivi.

Événements

Nom	Description
DetectedAllChanges	Événement déclenché quand des modifications ont été détectées dans le graphe d’entité, via un appel explicite à DetectChanges(), ou automatiquement, tel qu’une partie de l’exécution SaveChanges() ou SaveChangesAsync(CancellationToken).
DetectedEntityChanges	Événement déclenché quand des modifications ont été détectées sur une seule entité, via un appel explicite ou DetectChanges()DetectChanges()automatiquement, comme une partie de l’exécution SaveChanges() ou SaveChangesAsync(CancellationToken).
DetectingAllChanges	Un événement s’est déclenché lors de la détection des modifications apportées au graphe d’entité sur le point de se produire, soit par le biais d’un appel explicite à DetectChanges(), soit automatiquement, tel qu’une partie de l’exécution SaveChanges() ou SaveChangesAsync(CancellationToken).
DetectingEntityChanges	Un événement déclenché lors de la détection des modifications apportées à une seule entité est sur le point de se produire, soit par le biais d’un appel explicite à DetectChanges() ou DetectChanges(), soit automatiquement, tel qu’une partie de l’exécution SaveChanges() ou SaveChangesAsync(CancellationToken).
StateChanged	Événement déclenché lorsqu’une entité suivie par l’associé DbContext est passée d’une EntityState entité à une autre.
StateChanging	Événement déclenché lorsqu’une entité suivie par l’associé DbContext passe d’une entité EntityState à une autre.
Tracked	Événement déclenché lorsqu’une entité est suivie par le contexte, soit parce qu’elle a été retournée à partir d’une requête de suivi, soit parce qu’elle a été attachée ou ajoutée au contexte.
Tracking	Événement déclenché lorsqu’une entité est sur le point d’être suivie par le contexte, soit parce qu’elle est retournée à partir d’une requête de suivi, soit parce qu’elle est attachée ou ajoutée au contexte.

Implémentations d’interfaces explicites

Nom	Description
IResettableService.ResetState()	Réinitialise le service afin qu’il puisse être utilisé à partir du pool.
IResettableService.ResetStateAsync(CancellationToken)	Fournit l’accès aux informations et opérations de suivi des modifications pour les instances d’entité que le contexte effectue le suivi. Les instances de cette classe sont généralement obtenues ChangeTracker et elles ne sont pas conçues pour être directement construites dans votre code d’application.

Méthodes d’extension

Nom	Description
ToDebugString(ChangeTracker, ChangeTrackerDebugStringOptions, Int32)	Crée une représentation lisible par l’homme des métadonnées données. Avertissement : Ne vous appuyez pas sur le format de la chaîne retournée. Il est conçu pour le débogage uniquement et peut changer arbitrairement entre les versions.