EntityEntry<TEntity> Класс

Определение

Пространство имен:

Microsoft.EntityFrameworkCore.ChangeTracking

Сборка:

Microsoft.EntityFrameworkCore.dll

Пакет:

Microsoft.EntityFrameworkCore v1.0.6

Пакет:

Microsoft.EntityFrameworkCore v1.1.6

Пакет:

Microsoft.EntityFrameworkCore v2.0.3

Пакет:

Microsoft.EntityFrameworkCore v2.1.11

Пакет:

Microsoft.EntityFrameworkCore v2.2.6

Пакет:

Microsoft.EntityFrameworkCore v3.0.0

Пакет:

Microsoft.EntityFrameworkCore v3.1.0

Пакет:

Microsoft.EntityFrameworkCore v5.0.0

Пакет:

Microsoft.EntityFrameworkCore v6.0.0

Предоставляет доступ к сведениям об отслеживании изменений и операциям для данной сущности.

Экземпляры этого класса возвращаются из методов при использовании ChangeTracker API и не предназначены для непосредственного создания в коде приложения.

public class EntityEntry<TEntity> : Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry where TEntity : class

type EntityEntry<'Entity (requires 'Entity : null)> = class
    inherit EntityEntry

Public Class EntityEntry(Of TEntity)
Inherits EntityEntry

Параметры типа

TEntity

Тип сущности, отслеживаемой этой записью.

Наследование

Object

EntityEntry

EntityEntry<TEntity>

Комментарии

Дополнительные сведения см. в разделе "Доступ к отслеживаемой сущности" в EF Core .

Конструкторы

EntityEntry<TEntity>(InternalEntityEntry)

Это внутренний API, который поддерживает инфраструктуру Entity Framework Core и не соответствует тем же стандартам совместимости, что и общедоступные API. Его можно изменить или удалить без уведомления в любом выпуске. Его следует использовать только непосредственно в коде с крайней осторожностью и зная, что это может привести к сбоям приложений при обновлении до нового выпуска Entity Framework Core.

Свойства

Collections	Предоставляет доступ к сведениям об отслеживании изменений и загрузке сведений обо всех свойствах навигации коллекции этой сущности. (Унаследовано от EntityEntry)
Context	Возвращает контекст, отслеживающий сущность. (Унаследовано от EntityEntry)
CurrentValues	Возвращает текущие значения свойств для этой сущности. (Унаследовано от EntityEntry)
DebugView	Разверните это свойство в отладчике для пользовательского представления записи. Предупреждение. Не полагаться на формат строк отладки. Они предназначены только для отладки и могут изменяться произвольно между выпусками. (Унаследовано от EntityEntry)
Entity	Возвращает сущность, отслеживаемую этой записью.
InternalEntry	Это внутренний API, который поддерживает инфраструктуру Entity Framework Core и не соответствует тем же стандартам совместимости, что и общедоступные API. Его можно изменить или удалить без уведомления в любом выпуске. Его следует использовать только непосредственно в коде с крайней осторожностью и зная, что это может привести к сбоям приложений при обновлении до нового выпуска Entity Framework Core. (Унаследовано от EntityEntry)
IsKeySet	Возвращает значение, указывающее, назначены ли ключевые значения этой сущности. Для ключей с созданными хранилищем свойствами (например, сопоставление с столбцами Identity) возвращаемое значение будет false, если какое-либо из созданных в хранилище свойств имеет значение по умолчанию CLR. Для ключей без свойств, созданных в хранилище, возвращаемое значение всегда будет true, так как любое значение считается допустимым значением ключа. (Унаследовано от EntityEntry)
Members	Предоставляет доступ к сведениям об отслеживании изменений и операциям для всех свойств и свойств навигации этой сущности. (Унаследовано от EntityEntry)
Metadata	Возвращает метаданные о форме сущности, ее отношениях с другими сущностями и о том, как она сопоставляется с базой данных. (Унаследовано от EntityEntry)
Navigations	Предоставляет доступ к сведениям об отслеживании изменений и операциям для всех свойств навигации этой сущности. (Унаследовано от EntityEntry)
OriginalValues	Возвращает исходные значения свойств для этой сущности. Исходные значения — это значения свойств, так как они были при извлечении сущности из базы данных. Обратите внимание, что всякий раз, когда реальные исходные значения свойств недоступны (например, сущность еще не сохранена в базе данных или была извлечена в запросе без отслеживания), это значение по умолчанию будет иметь текущие значения свойств этой сущности. (Унаследовано от EntityEntry)
Properties	Предоставляет доступ к сведениям об отслеживании изменений и операциям для всех свойств этой сущности. (Унаследовано от EntityEntry)
References	Предоставляет доступ к сведениям об отслеживании изменений и загрузке данных для всех ссылочных свойств навигации (т. е. не коллекции) этой сущности. (Унаследовано от EntityEntry)
State	Возвращает или задает состояние, в котором отслеживается эта сущность. Этот метод задает только состояние одной сущности, представленной этой записью. Он не изменяет состояние других сущностей, доступных для этого объекта. При настройке состояния сущность всегда будет в конечном итоге в указанном состоянии. Например, если изменить состояние Deleted на сущность, она будет помечена для удаления независимо от его текущего состояния. Это отличается от вызова Remove(TEntity) , когда сущность будет отключена (а не помечена для удаления), если она находится в Added состоянии. (Унаследовано от EntityEntry)

Методы

Collection(String)	Предоставляет доступ к отслеживанию изменений и загрузке сведений для свойства навигации коллекции, которое связывает эту сущность с коллекцией других сущностей. (Унаследовано от EntityEntry)
Collection<TProperty>(Expression<Func<TEntity,IEnumerable<TProperty>>>)	Предоставляет доступ к отслеживанию изменений и загрузке сведений для свойства навигации коллекции, которое связывает эту сущность с коллекцией других сущностей.
Collection<TProperty>(String)	Предоставляет доступ к отслеживанию изменений и загрузке сведений для свойства навигации коллекции, которое связывает эту сущность с коллекцией других сущностей.
DetectChanges()	Сканирует этот экземпляр сущности, чтобы обнаружить любые изменения, внесенные в данные экземпляра. DetectChanges() обычно вызывается автоматически контекстом для получения актуальных сведений об отдельной сущности перед возвратом сведений об отслеживании изменений. Обычно этот метод необходимо вызывать только в том случае, если вы отключили AutoDetectChangesEnabled. (Унаследовано от EntityEntry)
GetDatabaseValues()	Запрашивает в базе данных копии значений отслеживаемой сущности в том виде, в котором они сейчас существуют в базе данных. Если сущность не найдена в базе данных, null возвращается. Обратите внимание, что изменение значений в возвращенном словаре не приведет к обновлению значений в базе данных. (Унаследовано от EntityEntry)
GetDatabaseValuesAsync(CancellationToken)	Запрашивает в базе данных копии значений отслеживаемой сущности в том виде, в котором они сейчас существуют в базе данных. Если сущность не найдена в базе данных, возвращается значение NULL. Обратите внимание, что изменение значений в возвращенном словаре не приведет к обновлению значений в базе данных. Несколько активных операций в одном экземпляре контекста не поддерживаются. Используйте await для обеспечения выполнения любых асинхронных операций перед вызовом другого метода в этом контексте. (Унаследовано от EntityEntry)
Member(String)	Предоставляет доступ к сведениям об отслеживании изменений и операциям для заданного свойства или свойства навигации этой сущности. (Унаследовано от EntityEntry)
Navigation(String)	Предоставляет доступ к сведениям и операциям отслеживания изменений для заданного свойства навигации этой сущности. (Унаследовано от EntityEntry)
Property(String)	Предоставляет доступ к сведениям об отслеживании изменений и операциям для заданного свойства этой сущности. (Унаследовано от EntityEntry)
Property<TProperty>(Expression<Func<TEntity,TProperty>>)	Предоставляет доступ к сведениям об отслеживании изменений и операциям для заданного свойства этой сущности.
Property<TProperty>(String)	Предоставляет доступ к сведениям об отслеживании изменений и операциям для заданного свойства этой сущности.
Reference(String)	Предоставляет доступ к отслеживанию изменений и загрузке информации для ссылочного свойства навигации (т. е. не коллекции), которое связывает эту сущность с другой сущностью. (Унаследовано от EntityEntry)
Reference<TProperty>(Expression<Func<TEntity,TProperty>>)	Предоставляет доступ к отслеживанию изменений и загрузке информации для ссылочного свойства навигации (т. е. не коллекции), которое связывает эту сущность с другой сущностью.
Reference<TProperty>(String)	Предоставляет доступ к отслеживанию изменений и загрузке информации для ссылочного свойства навигации (т. е. не коллекции), которое связывает эту сущность с другой сущностью.
Reload()	Повторно загружает сущность из базы данных, перезаписывая все значения свойств значениями из базы данных. Сущность будет находиться в Unchanged состоянии после вызова этого метода, если сущность не существует в базе данных, в этом случае сущность будет иметь значение Detached. Наконец, вызов перезагрузки для сущности Added , которая не существует в базе данных, не является операцией. Обратите внимание, что добавленная сущность еще не создала постоянное значение ключа. (Унаследовано от EntityEntry)
ReloadAsync(CancellationToken)	Повторно загружает сущность из базы данных, перезаписывая все значения свойств значениями из базы данных. Сущность будет находиться в Unchanged состоянии после вызова этого метода, если сущность не существует в базе данных, в этом случае сущность будет иметь значение Detached. Наконец, вызов перезагрузки для сущности Added , которая не существует в базе данных, не является операцией. Обратите внимание, что добавленная сущность еще не создала постоянное значение ключа. (Унаследовано от EntityEntry)

Явные реализации интерфейса

IInfrastructure<InternalEntityEntry>.Instance

Это внутренний API, который поддерживает инфраструктуру Entity Framework Core и не соответствует тем же стандартам совместимости, что и общедоступные API. Его можно изменить или удалить без уведомления в любом выпуске. Его следует использовать только непосредственно в коде с крайней осторожностью и зная, что это может привести к сбоям приложений при обновлении до нового выпуска Entity Framework Core. (Унаследовано от EntityEntry)

Методы расширения

GetInfrastructure<T>(IInfrastructure<T>)

Возвращает значение из свойства, скрытого с помощью IInfrastructure<T>. Этот метод обычно используется поставщиками баз данных (и другими расширениями). Обычно он не используется в коде приложения. IInfrastructure<T> используется для скрытия свойств, которые не предназначены для использования в коде приложения, но могут использоваться в методах расширения, написанных поставщиками баз данных и т. д.