ChangeTracker Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет доступ к сведениям об отслеживании изменений и операциям для экземпляров сущностей, которые отслеживает контекст. Экземпляры этого класса обычно получаются и ChangeTracker не предназначены для непосредственного создания в коде приложения.
public class ChangeTracker : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<Microsoft.EntityFrameworkCore.ChangeTracking.Internal.IStateManager>
[System.Runtime.CompilerServices.Nullable(0)]
public class ChangeTracker : Microsoft.EntityFrameworkCore.Infrastructure.IResettableService
public class ChangeTracker : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<Microsoft.EntityFrameworkCore.ChangeTracking.Internal.IStateManager>, Microsoft.EntityFrameworkCore.Infrastructure.IResettableService
public class ChangeTracker : Microsoft.EntityFrameworkCore.Infrastructure.IResettableService
type ChangeTracker = class
interface IInfrastructure<IStateManager>
[<System.Runtime.CompilerServices.Nullable(0)>]
type ChangeTracker = class
interface IResettableService
type ChangeTracker = class
interface IInfrastructure<IStateManager>
interface IResettableService
type ChangeTracker = class
interface IResettableService
Public Class ChangeTracker
Implements IInfrastructure(Of IStateManager)
Public Class ChangeTracker
Implements IResettableService
Public Class ChangeTracker
Implements IInfrastructure(Of IStateManager), IResettableService
- Наследование
-
ChangeTracker
- Атрибуты
- Реализации
-
IInfrastructure<Microsoft.EntityFrameworkCore.ChangeTracking.Internal.IStateManager> IResettableService
Комментарии
Дополнительные сведения и примеры см. в разделе отслеживания изменений EF Core .
Конструкторы
| Имя. | Описание |
|---|---|
| ChangeTracker(DbContext, IStateManager, IChangeDetector, IModel, IEntityEntryGraphIterator) |
Это внутренний API, который поддерживает инфраструктуру Entity Framework Core и не соответствует тем же стандартам совместимости, что и общедоступные API. Его можно изменить или удалить без уведомления в любом выпуске. Его следует использовать непосредственно в коде с крайней осторожностью и зная, что это может привести к сбоям приложений при обновлении до нового выпуска Entity Framework Core. |
| ChangeTracker(DbContext) |
Этот API поддерживает инфраструктуру Entity Framework Core и не предназначен для использования непосредственно из кода. Этот API может изменяться или удаляться в будущих выпусках. |
| ChangeTracker(IStateManager, IChangeDetector, IEntityEntryGraphIterator, DbContext) |
Этот API поддерживает инфраструктуру Entity Framework Core и не предназначен для использования непосредственно из кода. Этот API может изменяться или удаляться в будущих выпусках. |
Свойства
| Имя. | Описание |
|---|---|
| AutoDetectChangesEnabled |
Возвращает или задает значение, указывающее, вызывается ли DetectChanges() метод автоматически методами DbContext и связанными классами. |
| CascadeDeleteTiming |
Возвращает или задает значение, указывающее, когда зависимые или дочерние сущности будут иметь состояние, заданное Deleted после того, как ее родительская или основная сущность помечена как Deleted. Значением по умолчанию являетсяImmediate. |
| Context |
Возвращает контекст, к которому принадлежит средство отслеживания изменений. |
| DebugView |
Разверните это свойство в отладчике для удобочитаемого представления отслеживаемых сущностей. Предупреждение. Не полагаться на формат строк отладки. Они предназначены только для отладки и могут изменяться произвольно между выпусками. Дополнительные сведения и примеры см. в разделе отслеживания изменений EF Core . |
| DeleteOrphansTiming |
Возвращает или задает значение, указывающее, когда зависимые или дочерние сущности будут иметь Deleted состояние, равное как только отрезано от родительской или основной сущности через свойство навигации или внешнего ключа, для которых задано значение NULL. Значение по умолчанию — Immediate. |
| LazyLoadingEnabled |
Возвращает или задает значение, указывающее, будут ли свойства навигации для отслеживаемых сущностей загружаться при первом доступе. |
| QueryTrackingBehavior |
Возвращает или задает поведение отслеживания для запросов LINQ, выполняемых в контексте. Отключение отслеживания изменений полезно для сценариев только для чтения, так как это позволяет избежать затрат на настройку отслеживания изменений для каждого экземпляра сущности. Не следует отключать отслеживание изменений, если вы хотите управлять экземплярами сущностей и сохранять эти изменения в базе данных с помощью SaveChanges(). |
Методы
| Имя. | Описание |
|---|---|
| AcceptAllChanges() |
Принимает все изменения, внесенные в сущности в контексте. Предполагается, что отслеживаемые сущности представляют текущее состояние базы данных. Этот метод обычно вызывается SaveChanges() после успешного сохранения изменений в базе данных. |
| CascadeChanges() |
Вызывает немедленное каскадное удаление дочерних или зависимых сущностей, если они либо удалены из требуемой родительской или основной сущности, либо требуется сущность родительского или субъекта. См. DeleteBehavior. |
| Clear() |
Останавливает отслеживание всех отслеживаемых в настоящее время сущностей. |
| DetectChanges() |
Сканирует отслеживаемые экземпляры сущностей, чтобы обнаружить изменения, внесенные в данные экземпляра. DetectChanges() обычно вызывается автоматически контекстом, если требуется up-to-date information (до SaveChanges() и при возврате сведений об отслеживании изменений). Обычно этот метод необходимо вызывать только при отключении AutoDetectChangesEnabled. |
| Entries() |
Возвращает значение для каждой EntityEntry сущности, отслеживаемой контекстом. Записи предоставляют доступ к данным отслеживания изменений и операциям для каждой сущности. |
| Entries<TEntity>() |
EntityEntry Возвращает значение для всех сущностей заданного типа, отслеживаемых контекстом. Записи предоставляют доступ к данным отслеживания изменений и операциям для каждой сущности. |
| GetEntriesForState(Boolean, Boolean, Boolean, Boolean) |
Возвращает для каждой EntityEntry сущности, отслеживаемой контекстом с заданными состояниями. Записи предоставляют доступ к данным отслеживания изменений и операциям для каждой сущности. |
| GetEntriesForState<TEntity>(Boolean, Boolean, Boolean, Boolean) |
EntityEntry<TEntity> Получает для каждой сущности заданного типа, отслеживаемой контекстом с заданными состояниями. Записи предоставляют доступ к данным отслеживания изменений и операциям для каждой сущности. |
| HasChanges() |
Проверяет, будут ли отслеживаются новые, удаленные или измененные сущности, чтобы эти изменения были отправлены в базу данных SaveChanges() при вызове или SaveChangesAsync(CancellationToken) вызове. |
| TrackGraph(Object, Action<EntityEntryGraphNode>) |
Начинает отслеживание сущности и любых сущностей, доступных путем обхода его свойств навигации.
Обход является рекурсивным, поэтому свойства навигации любых обнаруженных сущностей также будут сканироваться.
Указанный |
| TrackGraph<TState>(Object, TState, Func<EntityEntryGraphNode,TState,Boolean>) |
Начинает отслеживание сущности и всех сущностей, доступных путем обхода свойств навигации.
Обход является рекурсивным, поэтому свойства навигации любых обнаруженных сущностей также будут сканироваться.
Указанный Этот метод предназначен для использования в отключенных сценариях, когда сущности извлекаются с помощью одного экземпляра контекста, а затем изменения сохраняются с помощью другого экземпляра контекста. Примером этого является веб-служба, в которой один вызов службы извлекает сущности из базы данных, а другой вызов службы сохраняет любые изменения сущностей. Каждый вызов службы использует новый экземпляр контекста, который удаляется при завершении вызова. Обычно обход графа должен останавливаться при обнаружении уже отслеживаемой сущности или при достижении сущности, которую не следует отслеживать. Для этого типичного поведения используйте перегрузку TrackGraph(Object, Action<EntityEntryGraphNode>) . Эта перегрузка, с другой стороны, позволяет обратному вызову решать, когда будет заканчиваться обход, но то, на которое выполняется вызов, чтобы убедиться, что обход не будет входить в бесконечный цикл. |
| TrackGraph<TState>(Object, TState, Func<EntityEntryGraphNode<TState>,Boolean>) |
Начинает отслеживание сущности и любых сущностей, доступных путем обхода его свойств навигации.
Обход является рекурсивным, поэтому свойства навигации любых обнаруженных сущностей также будут сканироваться.
Указанный |
События
| Имя. | Описание |
|---|---|
| DetectedAllChanges |
Событие, возникающее при обнаружении каких-либо изменений в графе сущностей с помощью явного вызова DetectChanges()или автоматического вызова, например при выполнении SaveChanges() или SaveChangesAsync(CancellationToken). |
| DetectedEntityChanges |
Событие, возникающее при обнаружении каких-либо изменений для одной сущности, путем явного вызова DetectChanges() или DetectChanges()автоматического вызова, например при выполнении или SaveChangesAsync(CancellationToken)автоматическом выполненииSaveChanges(). |
| DetectingAllChanges |
Событие, выполняемое при обнаружении изменений в графе сущностей, происходит либо с помощью явного вызоваDetectChanges(), либо автоматически, например при выполнении или SaveChangesAsync(CancellationToken)выполненииSaveChanges(). |
| DetectingEntityChanges |
Событие, возникающее при обнаружении изменений в одной сущности, происходит либо с помощью явного вызоваDetectChanges(), либо DetectChanges()автоматически, например при выполнении или SaveChangesAsync(CancellationToken)автоматическом выполненииSaveChanges(). |
| StateChanged |
Событие, возникающее, когда сущность, отслеживаемая связанной DbContext , перемещена из одной EntityState в другую. |
| StateChanging |
Событие, возникающее, когда сущность, отслеживаемая связанной DbContext , перемещается с одной EntityState на другую. |
| Tracked |
Событие, возникающее при отслеживании сущности контекстом, либо из-за того, что она была возвращена из запроса отслеживания, либо из-за того, что она была присоединена или добавлена в контекст. |
| Tracking |
Событие, возникающее, когда сущность будет отслеживаться контекстом, либо из-за того, что она возвращается из запроса отслеживания, либо потому что она присоединяется или добавляется в контекст. |
Явные реализации интерфейса
| Имя. | Описание |
|---|---|
| IInfrastructure<IStateManager>.Instance |
Устаревшие.
Возвращает внутренний диспетчер состояний, используемый для хранения сведений об отслеживаемых сущностях. Это свойство предназначено для использования методами расширения. Он не предназначен для использования в коде приложения. |
| IResettableService.ResetState() |
Сбрасывает службу, чтобы ее можно было использовать из пула. |
| IResettableService.ResetStateAsync(CancellationToken) |
Предоставляет доступ к сведениям об отслеживании изменений и операциям для экземпляров сущностей, которые отслеживает контекст. Экземпляры этого класса обычно получаются и ChangeTracker не предназначены для непосредственного создания в коде приложения. |
Методы расширения
| Имя. | Описание |
|---|---|
| GetInfrastructure<T>(IInfrastructure<T>) |
Возвращает значение из свойства, скрытого с помощью IInfrastructure<T>. Этот метод обычно используется поставщиками баз данных (и другими расширениями). Обычно он не используется в коде приложения. |
| ToDebugString(ChangeTracker, ChangeTrackerDebugStringOptions, Int32) |
Создает удобочитаемое представление заданных метаданных. Предупреждение. Не полагаться на формат возвращаемой строки. Он предназначен только для отладки и может изменяться произвольно между выпусками. |