change-tracking
Implementation details for EF Core change tracking. Use when changing InternalEntityEntry, ChangeDetector, SnapshotFactoryFactory, or related entity state, snapshot, or property accessor code.
How do I install this agent skill?
npx skills add https://github.com/dotnet/efcore --skill change-trackingIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides implementation details and documentation for Entity Framework Core's change tracking system. No security issues were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Change Tracking
Manages entity states and detects changes for SaveChanges().
Core Components
StateManager— owns tracked entries, identity/reference maps, fixup, cascades, notifications, and changed countsInternalEntryBaseand derived classes — own per-entry state, flags, values, snapshots, and ordered state transitionsChangeDetector— compares current values with baselines and reports changes through entry mutation APIsSnapshotFactoryFactorysubclasses — create passive original- and relationship-value baselinesIdentityMap— permits one active entry per key; shared identity pairs a replacement with the priorDeletedentryPropertyAccessorsFactory,ClrPropertyGetterFactoryandClrPropertySetterFactorycompile property accessors for efficient snapshotting and change detection- Ordinals in
indicesparameter specify element at each complex collection depth
- Ordinals in
Change Detection
- Snapshot and notification strategies both call
SetPropertyModified()to keep property flags and entity state consistent. SetEntityState()validates values, updates flags and complex entries, changes state, then runs manager bookkeeping hooks.
Shared-Identity Replacement
SharedIdentityEntry is the invariant that distinguishes an old deleted entry from its replacement with the same identity. When attaching a replacement graph, a deleted nested entry should be reconsidered only when its source entry has a replacement; do not broadly process every deleted node. Likewise, cascading from the old replaced principal must not delete dependents that belong to the replacement graph. Keep synchronous and asynchronous graph-attach paths equivalent and preserve unrelated values in replacement tests so they isolate the identity transition.
Testing
Unit tests: test/EFCore.Tests/ChangeTracking/. Functional tests: test/EFCore.Specification.Tests/GraphUpdates/.
Common Pitfalls
| Pitfall | Solution |
|---|---|
| State-based checks treat every Added/Deleted entry as a replacement | Scope replacement behavior through SharedIdentityEntry and the graph source |
Validation
DetectChanges()identifies modified properties via snapshot comparison- Setting original values marks properties as modified or unchanged based on comparison with current values
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/dotnet/efcore/change-tracking">View change-tracking on skillZs</a>