ChangeTracker Třída

Definice

Obor názvů:

Microsoft.EntityFrameworkCore.ChangeTracking

Sestavení:

Microsoft.EntityFrameworkCore.dll

Balíček:

Microsoft.EntityFrameworkCore v8.0.0

Poskytuje přístup k informacím a operacím sledování změn pro instance entit, které kontext sleduje. Instance této třídy se obvykle získávají z ChangeTracker a nejsou navrženy tak, aby byly přímo vytvořeny v kódu aplikace.

public class ChangeTracker : Microsoft.EntityFrameworkCore.Infrastructure.IResettableService

type ChangeTracker = class
    interface IResettableService

Public Class ChangeTracker
Implements IResettableService

Dědičnost

Object

ChangeTracker

Implementuje

IResettableService

Poznámky

Další informace a příklady najdete v tématu Sledování změn EF Core .

Konstruktory

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

Toto je interní rozhraní API, které podporuje infrastrukturu Entity Framework Core a nepodléhá stejným standardům kompatibility jako veřejná rozhraní API. Může se změnit nebo odebrat bez předchozího upozornění v jakékoli verzi. Měli byste ho používat přímo v kódu pouze s extrémní opatrností a s vědomím, že to může vést k selhání aplikací při aktualizaci na novou verzi Entity Framework Core.

Vlastnosti

AutoDetectChangesEnabled	Získá nebo nastaví hodnotu označující, zda DetectChanges() je metoda volána automaticky metodami DbContext a související třídy.
CascadeDeleteTiming	Získá nebo nastaví hodnotu označující, kdy závislá nebo podřízená entita bude mít stav nastavený na, Deleted jakmile je její nadřazená nebo hlavní entita označena jako Deleted. Výchozí hodnota jeImmediate.
Context	Získá kontext, do který patří sledování změn.
DebugView	Rozbalte tuto vlastnost v ladicím programu a zobrazte tak čitelné zobrazení sledovaných entit. Upozornění: Nespoléhejte na formát řetězců ladění. Jsou určené pouze pro ladění a mezi verzemi se můžou libovolně měnit. Další informace a příklady najdete v tématu Sledování změn EF Core .
DeleteOrphansTiming	Získá nebo nastaví hodnotu označující, kdy závislá/podřízená entita bude mít svůj stav nastaven na Deleted po oddělení od nadřazené/hlavní entity buď navigační nebo cizí klíč vlastnost nastavena na hodnotu null. Výchozí hodnota je Immediate.
LazyLoadingEnabled	Získá nebo nastaví hodnotu určující, zda navigační vlastnosti pro sledované entity budou načteny při prvním přístupu.
QueryTrackingBehavior	Získá nebo nastaví chování sledování linq dotazy spuštěné v kontextu. Zakázání sledování změn je užitečné ve scénářích jen pro čtení, protože se tím vyhnete režijním nákladům na nastavení sledování změn pro každou instanci entity. Sledování změn byste neměli zakázat, pokud chcete manipulovat s instancemi entit a zachovat tyto změny v databázi pomocí SaveChanges().

Metody

AcceptAllChanges()	Přijímá všechny změny provedené v entitách v kontextu. Předpokládá se, že sledované entity představují aktuální stav databáze. Tuto metodu obvykle volá po SaveChanges() úspěšném uložení změn do databáze.
CascadeChanges()	Vynutí okamžité kaskádové odstranění podřízených nebo závislých entit, pokud jsou buď odděleny od požadované nadřazené nebo hlavní entity, nebo je odstraněna samotná požadovaná nadřazená/hlavní entita. Viz třída DeleteBehavior.
Clear()	Zastaví sledování všech aktuálně sledovaných entit.
DetectChanges()	Zkontroluje instance sledovaných entit a zjistí změny provedené v datech instance. DetectChanges() je obvykle volána automaticky kontextem, když jsou vyžadovány aktuální informace (před SaveChanges() a při vrácení informací o sledování změn). Tuto metodu obvykle potřebujete volat pouze v případě, že jste zakázali AutoDetectChangesEnabled. Další informace a příklady najdete v tématu Sledování změn EF Core .
Entries()	Vrátí hodnotu EntityEntry pro každou entitu, kterou sleduje kontext. Tyto položky poskytují přístup k informacím a operacím sledování změn pro každou entitu.
Entries<TEntity>()	Získá pro EntityEntry všechny entity daného typu sledování kontextem. Tyto položky poskytují přístup k informacím a operacím sledování změn pro každou entitu.
HasChanges()	Zkontroluje, jestli jsou sledovány nějaké nové, odstraněné nebo změněné entity, aby se tyto změny odeslaly do databáze, pokud SaveChanges() je volána nebo SaveChangesAsync(CancellationToken) je volána.
TrackGraph(Object, Action<EntityEntryGraphNode>)	Začne sledovat entitu a všechny entity, které jsou dostupné procházením jejích navigačních vlastností. Procházení je rekurzivní, takže se budou kontrolovat i navigační vlastnosti všech zjištěných entit. Zadaný callback je volána pro každou zjištěnou entitu State a musí nastavit, ve které se má každá entita sledovat. Pokud není nastavený žádný stav, zůstane entita nesledovaná.
TrackGraph<TState>(Object, TState, Func<EntityEntryGraphNode<TState>,Boolean>)	Začne sledovat entitu a všechny entity, které jsou dostupné procházením jejích navigačních vlastností. Procházení je rekurzivní, takže se budou kontrolovat i navigační vlastnosti všech zjištěných entit. Zadaný callback je volána pro každou zjištěnou entitu State a musí nastavit, ve které se má každá entita sledovat. Pokud není nastavený žádný stav, zůstane entita nesledovaná.

Událost

DetectedAllChanges	Událost se aktivovala, když byly zjištěny jakékoli změny v grafu entit, a to buď explicitním voláním DetectChanges(), nebo automaticky, například při provádění SaveChanges() nebo SaveChangesAsync(CancellationToken).
DetectedEntityChanges	Událost se aktivuje, když byly zjištěny jakékoli změny v jedné entitě, a to buď explicitním voláním DetectChanges() nebo DetectChanges(), nebo automaticky, například při provádění SaveChanges() nebo SaveChangesAsync(CancellationToken).
DetectingAllChanges	Událost se aktivovala při zjišťování změn v grafu entit, ke které má dojít, a to buď explicitním voláním DetectChanges(), nebo automaticky, například při provádění SaveChanges() nebo SaveChangesAsync(CancellationToken).
DetectingEntityChanges	Událost aktivovaná při zjišťování změn v jedné entitě se chystá nastat, a to buď explicitním voláním DetectChanges() nebo DetectChanges(), nebo automaticky, například při provádění SaveChanges() nebo SaveChangesAsync(CancellationToken).
StateChanged	Událost se aktivovala, když se entita, která je sledována přidruženou entitou DbContext , přesunula z jedné EntityState do druhé.
StateChanging	Událost se aktivuje, když se entita, která je sledována přidruženou DbContext entitou, přesouvá z jedné EntityState na jinou.
Tracked	Událost se aktivuje, když je entita sledována kontextem, a to buď proto, že byla vrácena ze sledovacího dotazu, nebo proto, že byla připojena nebo přidána do kontextu.
Tracking	Událost se aktivuje, když se entita chystá sledovat kontext, a to buď proto, že je vrácena ze sledovacího dotazu, nebo proto, že je připojena nebo přidána do kontextu.

Explicitní implementace rozhraní

IResettableService.ResetState()	Resetuje službu, aby ji bylo možné použít z fondu.
IResettableService.ResetStateAsync(CancellationToken)	Poskytuje přístup k informacím a operacím sledování změn pro instance entit, které kontext sleduje. Instance této třídy se obvykle získávají z ChangeTracker a nejsou navrženy tak, aby byly přímo vytvořeny v kódu aplikace.

Metody rozšíření

ToDebugString(ChangeTracker, ChangeTrackerDebugStringOptions, Int32)

Vytvoří čitelné vyjádření daných metadat. Upozornění: Nespoléhejte na formát vráceného řetězce. Je určen pouze pro ladění a mezi verzemi se může libovolně měnit.