ChangeTracker Classe

Definizione

Spazio dei nomi:

Microsoft.EntityFrameworkCore.ChangeTracking

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacchetto:

Microsoft.EntityFrameworkCore v8.0.0

Fornisce l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per le istanze dell'entità in cui viene eseguito il rilevamento del contesto. Le istanze di questa classe vengono in genere ottenute da ChangeTracker e non sono progettate per essere costruite direttamente nel codice dell'applicazione.

public class ChangeTracker : Microsoft.EntityFrameworkCore.Infrastructure.IResettableService

type ChangeTracker = class
    interface IResettableService

Public Class ChangeTracker
Implements IResettableService

Ereditarietà

Object

ChangeTracker

Implementazioni

IResettableService

Commenti

Per altre informazioni ed esempi, vedere Rilevamento delle modifiche di EF Core .

Costruttori

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

Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in nessuna versione. È consigliabile usarlo direttamente nel codice con attenzione estrema e sapere che ciò può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.

Proprietà

AutoDetectChangesEnabled	Ottiene o imposta un valore che indica se il DetectChanges() metodo viene chiamato automaticamente da metodi di DbContext e classi correlate.
CascadeDeleteTiming	Ottiene o imposta un valore che indica quando un'entità dipendente/figlio avrà lo stato impostato su Deleted una volta che l'entità padre/entità principale è stata contrassegnata come Deleted. Il valore predefinito èImmediate.
Context	Ottiene il contesto a cui appartiene questo localizzatore di modifiche.
DebugView	Espandere questa proprietà nel debugger per una visualizzazione leggibile delle entità rilevate. Avviso: non basarsi sul formato delle stringhe di debug. Sono progettati solo per il debug e possono cambiare arbitrariamente tra le versioni. Per altre informazioni ed esempi, vedere Rilevamento delle modifiche di EF Core .
DeleteOrphansTiming	Ottiene o imposta un valore che indica quando un'entità dipendente/figlio avrà lo stato impostato su una volta grave da un'entità padre/entità principale tramite una proprietà di spostamento o chiave esterna impostata su Deleted Null. Il valore predefinito è Immediate.
LazyLoadingEnabled	Ottiene o imposta un valore che indica se le proprietà di spostamento per le entità rilevate verranno caricate per la prima volta.
QueryTrackingBehavior	Ottiene o imposta il comportamento di rilevamento per le query LINQ eseguite nel contesto. La disabilitazione del rilevamento delle modifiche è utile per scenari di sola lettura perché evita il sovraccarico della configurazione del rilevamento delle modifiche per ogni istanza di entità. Non è consigliabile disabilitare il rilevamento delle modifiche se si desidera modificare le istanze di entità e rendere persistenti tali modifiche al database usando SaveChanges().

Metodi

AcceptAllChanges()	Accetta tutte le modifiche apportate alle entità nel contesto. Si presuppone che le entità monitorate rappresentino lo stato corrente del database. Questo metodo viene in genere chiamato da SaveChanges() dopo che le modifiche sono state salvate correttamente nel database.
CascadeChanges()	Forza l'eliminazione immediata a catena delle entità figlio/dipendente quando vengono gravemente eliminate da un'entità padre/entità principale richiesta oppure l'entità padre/entità principale richiesta viene eliminata. Vedere DeleteBehavior.
Clear()	Arresta il rilevamento di tutte le entità attualmente monitorate.
DetectChanges()	Analizza le istanze di entità rilevate per rilevare le modifiche apportate ai dati dell'istanza. DetectChanges() viene in genere chiamato automaticamente dal contesto quando sono necessarie informazioni aggiornate (prima SaveChanges() e quando restituisce le informazioni di rilevamento delle modifiche). In genere è necessario chiamare questo metodo solo se è stato disabilitato AutoDetectChangesEnabled. Per altre informazioni ed esempi, vedere Rilevamento delle modifiche di EF Core .
Entries()	Restituisce un oggetto EntityEntry per ogni entità monitorata dal contesto. Le voci forniscono l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per ogni entità.
Entries<TEntity>()	Ottiene un EntityEntry oggetto per tutte le entità di un determinato tipo monitorato dal contesto. Le voci forniscono l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per ogni entità.
HasChanges()	Verifica se vengono rilevate entità nuove, eliminate o modificate in modo che queste modifiche vengano inviate al database se SaveChanges() o SaveChangesAsync(CancellationToken) viene chiamato.
TrackGraph(Object, Action<EntityEntryGraphNode>)	Inizia a tenere traccia di un'entità e di tutte le entità raggiungibili passando le proprietà di spostamento. L'attraversamento è ricorsivo, pertanto verranno analizzate anche le proprietà di spostamento di qualsiasi entità individuata. L'oggetto specificato callback viene chiamato per ogni entità individuata e deve impostare l'oggetto State in cui deve essere rilevata ogni entità. Se non viene impostato alcun stato, l'entità rimane non tracciata.
TrackGraph<TState>(Object, TState, Func<EntityEntryGraphNode<TState>,Boolean>)	Inizia a tenere traccia di un'entità e di tutte le entità raggiungibili passando le proprietà di spostamento. L'attraversamento è ricorsivo, pertanto verranno analizzate anche le proprietà di spostamento di qualsiasi entità individuata. L'oggetto specificato callback viene chiamato per ogni entità individuata e deve impostare l'oggetto State in cui deve essere rilevata ogni entità. Se non viene impostato alcun stato, l'entità rimane non tracciata.

Eventi

DetectedAllChanges	Evento generato quando sono state rilevate modifiche al grafico dell'entità, tramite una chiamata esplicita a DetectChanges()o automaticamente, ad esempio parte dell'esecuzione SaveChanges() o SaveChangesAsync(CancellationToken).
DetectedEntityChanges	Evento generato quando sono state rilevate modifiche a una singola entità, tramite una chiamata esplicita a DetectChanges() o o automaticamente, ad esempio parte dell'esecuzione SaveChanges() o DetectChanges()SaveChangesAsync(CancellationToken).
DetectingAllChanges	Evento generato durante il rilevamento delle modifiche apportate al grafico delle entità, tramite una chiamata esplicita a DetectChanges()o automaticamente, ad esempio parte dell'esecuzione SaveChanges() o SaveChangesAsync(CancellationToken).
DetectingEntityChanges	Un evento generato durante il rilevamento delle modifiche a una singola entità sta per verificarsi, tramite una chiamata esplicita a DetectChanges() o o o automaticamente, ad esempio parte dell'esecuzione SaveChanges() o DetectChanges()SaveChangesAsync(CancellationToken).
StateChanged	Evento generato quando un'entità rilevata dall'oggetto associato DbContext è stata spostata da una EntityState all'altra.
StateChanging	Evento generato quando un'entità rilevata dall'oggetto associato DbContext passa da una EntityState all'altra.
Tracked	Evento generato quando un'entità viene rilevata dal contesto, perché è stata restituita da una query di rilevamento o perché è stata associata o aggiunta al contesto.
Tracking	Evento generato quando un'entità sta per essere tracciata dal contesto, perché viene restituita da una query di rilevamento o perché viene associata o aggiunta al contesto.

Implementazioni dell'interfaccia esplicita

IResettableService.ResetState()	Reimposta il servizio in modo che possa essere usato dal pool.
IResettableService.ResetStateAsync(CancellationToken)	Fornisce l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per le istanze dell'entità in cui viene eseguito il rilevamento del contesto. Le istanze di questa classe vengono in genere ottenute da ChangeTracker e non sono progettate per essere costruite direttamente nel codice dell'applicazione.

Metodi di estensione

ToDebugString(ChangeTracker, ChangeTrackerDebugStringOptions, Int32)

Crea una rappresentazione leggibile dei metadati specificati. Avviso: non basarsi sul formato della stringa restituita. È progettato solo per il debug e può cambiare arbitrariamente tra le versioni.