LocalView<TEntity> Класс

Ссылка

Определение

Пространство имен:: Microsoft.EntityFrameworkCore.ChangeTracking

Сборка:: Microsoft.EntityFrameworkCore.dll

Пакет:: 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

Пакет:: Microsoft.EntityFrameworkCore v7.0.0

Пакет:: Microsoft.EntityFrameworkCore v8.0.0

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Коллекция, которая синхронизируется с сущностями заданного типа, отслеживаемыми DbContext. Вызовите Local , чтобы получить локальное представление.

public class LocalView<TEntity> : System.Collections.Generic.ICollection<TEntity>, System.Collections.Generic.IEnumerable<TEntity>, System.Collections.Specialized.INotifyCollectionChanged, System.ComponentModel.INotifyPropertyChanged, System.ComponentModel.INotifyPropertyChanging where TEntity : class

public class LocalView<TEntity> : System.Collections.Generic.ICollection<TEntity>, System.Collections.Generic.IEnumerable<TEntity>, System.Collections.Specialized.INotifyCollectionChanged, System.ComponentModel.IListSource, System.ComponentModel.INotifyPropertyChanged, System.ComponentModel.INotifyPropertyChanging where TEntity : class

type LocalView<'Entity (requires 'Entity : null)> = class
    interface ICollection<'Entity (requires 'Entity : null)>
    interface seq<'Entity (requires 'Entity : null)>
    interface IEnumerable
    interface INotifyCollectionChanged
    interface INotifyPropertyChanged
    interface INotifyPropertyChanging

type LocalView<'Entity (requires 'Entity : null)> = class
    interface ICollection<'Entity (requires 'Entity : null)>
    interface seq<'Entity (requires 'Entity : null)>
    interface IEnumerable
    interface INotifyCollectionChanged
    interface INotifyPropertyChanged
    interface INotifyPropertyChanging
    interface IListSource

Public Class LocalView(Of TEntity)
Implements ICollection(Of TEntity), IEnumerable(Of TEntity), INotifyCollectionChanged, INotifyPropertyChanged, INotifyPropertyChanging

Public Class LocalView(Of TEntity)
Implements ICollection(Of TEntity), IEnumerable(Of TEntity), IListSource, INotifyCollectionChanged, INotifyPropertyChanged, INotifyPropertyChanging

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

TEntity

Тип сущности в локальном представлении.

Наследование: Object
LocalView<TEntity>

Реализации: ICollection<TEntity> IEnumerable<T> IEnumerable<TEntity> IEnumerable INotifyCollectionChanged INotifyPropertyChanged INotifyPropertyChanging IListSource

Это локальное представление остается синхронизированным по мере добавления или удаления сущностей из контекста. Аналогичным образом добавляемые или удаляемые из этого локального представления сущности автоматически добавляются в контекст или удаляются из контекста.

Добавление сущности в эту коллекцию приведет к тому, что она будет отслеживаться в Added состоянии контекстом, если она еще не отслеживается.

Удаление сущности из этой коллекции приведет к тому, что она будет помечена как Deleted, если она не была ранее в состоянии Добавлена. В этом случае она будет отсоединяться от контекста.

Коллекция реализует INotifyCollectionChanged, INotifyPropertyChangingи INotifyPropertyChanging таким образом, что уведомления создаются, когда сущность начинает отслеживаться контекстом или помечена как Deleted или Detached.

Не используйте этот тип напрямую для привязки данных. Вместо этого вызовите ToObservableCollection() для привязки WPF или ToBindingList() для WinForms.

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

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

LocalView<TEntity>(DbSet<TEntity>)

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

Свойства

Count	Количество отслеживаемых сущностей типа TEntity, которые не помечены как Удаленные.
IsReadOnly	False, так как коллекция не доступна только для чтения.

Методы

Add(TEntity)	Добавляет новую сущность в DbContext. Если сущность не отслеживается или в настоящее время помечается как удаленная, она будет отслеживаться как Added.
Clear()	Помечает все сущности типа TEntity, отслеживаемые с DbContext Deletedпомощью .
Contains(TEntity)	Возвращает значение `true` , если сущность отслеживается контекстом и не помечена как Удаленная.
CopyTo(TEntity[], Int32)	Копирует в массив все сущности типа TEntity, которые отслеживаются и не помечены как Удаленные.
FindEntry(IEnumerable<IProperty>, IEnumerable<Object>)	EntityEntry<TEntity> Возвращает для первой сущности, отслеживаемой контекстом, в котором значение заданного свойства соответствует заданным значениям. Запись предоставляет доступ к сведениям об отслеживании изменений и операциям для сущности.
FindEntry(IEnumerable<String>, IEnumerable<Object>)	EntityEntry<TEntity> Возвращает для первой сущности, отслеживаемой контекстом, в котором значение заданного свойства соответствует заданным значениям. Запись предоставляет доступ к сведениям об отслеживании изменений и операциям для сущности.
FindEntry<TKey>(TKey)	EntityEntry<TEntity> Находит объект для сущности с заданным значением первичного ключа в отслеживании изменений, если он отслеживается. `null` Возвращается, если не отслеживается сущность с заданным значением ключа. Этот метод никогда не запрашивает базу данных.
FindEntry<TProperty>(IProperty, TProperty)	EntityEntry<TEntity> Возвращает для первой сущности, отслеживаемой контекстом, где значение заданного свойства соответствует заданному значению. Запись предоставляет доступ к сведениям об отслеживании изменений и операциям для сущности.
FindEntry<TProperty>(String, TProperty)	EntityEntry<TEntity> Возвращает для первой сущности, отслеживаемой контекстом, где значение заданного свойства соответствует заданному значению. Запись предоставляет доступ к сведениям об отслеживании изменений и операциям для сущности.
FindEntryUntyped(IEnumerable<Object>)	EntityEntry<TEntity> Находит объект для сущности с заданными значениями первичного ключа в отслеживании изменений, если он отслеживается. `null` Возвращается, если не отслеживается сущность с заданными значениями ключа. Этот метод никогда не запрашивает базу данных.
GetEntries(IEnumerable<IProperty>, IEnumerable<Object>)	Возвращает для каждой EntityEntry сущности, отслеживаемой контекстом, в котором значения заданных свойств соответствуют заданным значениям. Записи предоставляют доступ к сведениям и операциям отслеживания изменений для каждой сущности.
GetEntries(IEnumerable<String>, IEnumerable<Object>)	Возвращает для каждой EntityEntry сущности, отслеживаемой контекстом, в котором значения заданных свойств соответствуют заданным значениям. Записи предоставляют доступ к сведениям и операциям отслеживания изменений для каждой сущности.
GetEntries<TProperty>(IProperty, TProperty)	Возвращает для каждой EntityEntry<TEntity> сущности, отслеживаемой контекстом, в котором значение заданного свойства соответствует заданному значению. Записи предоставляют доступ к сведениям и операциям отслеживания изменений для каждой сущности.
GetEntries<TProperty>(String, TProperty)	Возвращает для каждой EntityEntry<TEntity> сущности, отслеживаемой контекстом, в котором значение заданного свойства соответствует заданному значению. Записи предоставляют доступ к сведениям и операциям отслеживания изменений для каждой сущности.
GetEnumerator()	IEnumerator<T> Возвращает для всех отслеживаемых сущностей типа TEntity, которые не помечены как удаленные.
OnCollectionChanged(NotifyCollectionChangedEventArgs)	Вызывает событие CollectionChanged.
OnPropertyChanged(PropertyChangedEventArgs)	Вызывает событие PropertyChanged.
OnPropertyChanging(PropertyChangingEventArgs)	Вызывает событие PropertyChanging.
Remove(TEntity)	Помечает заданную сущность как Deleted.
Reset()	Сбрасывает это представление, очищая все IBindingList созданные с ToBindingList() помощью и ObservableCollection<T> созданные с помощью ToObservableCollection(), а также очищает все события, зарегистрированные в PropertyChanged, PropertyChangingили CollectionChanged.
ToBindingList()	Возвращает реализацию BindingList<T> , которая синхронизируется с этой коллекцией. Используйте его для привязки данных WinForms.
ToObservableCollection()	Возвращает реализацию ObservableCollection<T> , которая синхронизируется с этой коллекцией. Используйте его для привязки данных WPF.

События

CollectionChanged	Происходит при изменении содержимого коллекции либо из-за непосредственного добавления или удаления сущности из коллекции, либо из-за того, что сущность начинает отслеживаться, либо потому, что сущность помечена как Удаленная.
PropertyChanged	Происходит при изменении свойства данной коллекции (например, Count).
PropertyChanging	Происходит при изменении свойства этой коллекции (например Count, ).

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

IEnumerable.GetEnumerator()	IEnumerator<T> Возвращает для всех отслеживаемых сущностей типа TEntity, которые не помечены как удаленные.
IListSource.ContainsListCollection	Возвращает значение, указывающее, является ли коллекция коллекцией объектов System.Collections.IList. Всегда возвращает значение `false`.
IListSource.GetList()	Этот метод вызывается платформами привязки данных при попытке выполнить привязку данных непосредственно к LocalView<TEntity>.

Применяется к

Поделиться через