Язык

LocalView<TEntity> Класс

Определение

Коллекция, которая остается в синхронизации с сущностями заданного типа, отслеживаемой .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
[System.Runtime.CompilerServices.Nullable(0)]
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
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
[<System.Runtime.CompilerServices.Nullable(0)>]
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
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

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

Наследование
LocalView<TEntity>
Атрибуты
Реализации

Комментарии

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

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

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

Коллекция реализует INotifyCollectionChangedи INotifyPropertyChangingINotifyPropertyChangingсоздает уведомления, когда сущность начинает отслеживаться контекстом или помечена как 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 созданные и ObservableCollection<T> созданные с ToObservableCollection()ToBindingList() помощью и очищая все события, зарегистрированные в 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>.

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