LocalView<TEntity> Klasa

Definicja

Przestrzeń nazw:

Microsoft.EntityFrameworkCore.ChangeTracking

Zestaw:

Microsoft.EntityFrameworkCore.dll

Pakiet:

Microsoft.EntityFrameworkCore v8.0.0

Kolekcja, która pozostaje zsynchronizowana z jednostkami danego typu śledzonym przez DbContextobiekt . Wywołaj wywołanie Local , aby uzyskać widok lokalny.

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
    interface IListSource

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

Parametry typu

TEntity

Typ jednostki w widoku lokalnym.

Dziedziczenie

Object

LocalView<TEntity>

Implementuje

ICollection<TEntity> IEnumerable<T> IEnumerable<TEntity> IEnumerable INotifyCollectionChanged INotifyPropertyChanged INotifyPropertyChanging IListSource

Uwagi

Ten widok lokalny pozostanie zsynchronizowany, ponieważ jednostki zostaną dodane lub usunięte z kontekstu. Podobnie jednostki dodane do lub usunięte z widoku lokalnego zostaną automatycznie dodane do lub usunięte z kontekstu.

Dodanie jednostki do tej kolekcji spowoduje, że będzie ona śledzona w Added stanie przez kontekst, chyba że jest już śledzona.

Usunięcie jednostki z tej kolekcji spowoduje, że zostanie ona oznaczona jako Deleted, chyba że została wcześniej w stanie Dodano, w takim przypadku zostanie odłączona od kontekstu.

Kolekcja implementuje INotifyCollectionChanged, INotifyPropertyChangingi INotifyPropertyChanging takie, że powiadomienia są generowane po rozpoczęciu śledzenia jednostki przez kontekst lub jest oznaczony jako Deleted lub Detached.

Nie używaj tego typu bezpośrednio do powiązania danych. Zamiast tego wywołaj ToObservableCollection() powiązanie WPF lub ToBindingList() winForms.

Aby uzyskać więcej informacji i przykładów, zobacz Widoki lokalne śledzonych jednostek w programie EF Core .

Konstruktory

LocalView<TEntity>(DbSet<TEntity>)

Jest to wewnętrzny interfejs API, który obsługuje infrastrukturę Entity Framework Core i nie podlega tym samym standardom zgodności co publiczne interfejsy API. Można go zmienić lub usunąć bez powiadomienia w jakiejkolwiek wersji. Należy używać go bezpośrednio w kodzie z wyjątkową ostrożnością i wiedzieć, że może to spowodować błędy aplikacji podczas aktualizowania do nowej wersji programu Entity Framework Core.

Właściwości

Count	Liczba jednostek typu TEntity, które są śledzone i nie są oznaczone jako Usunięte.
IsReadOnly	Fałsz, ponieważ kolekcja nie jest tylko do odczytu.

Metody

Add(TEntity)	Dodaje nową jednostkę do elementu DbContext. Jeśli jednostka nie jest śledzona lub jest obecnie oznaczona jako usunięta, zostanie ona śledzona jako Added.
Clear()	Oznacza wszystkie jednostki typu TEntity śledzone przez DbContext element jako Deleted.
Contains(TEntity)	Zwraca wartość true , jeśli jednostka jest śledzona przez kontekst i nie została oznaczona jako Usunięta.
CopyTo(TEntity[], Int32)	Kopie do tablicy wszystkie jednostki typu TEntity, które są śledzone i nie są oznaczone jako Usunięte.
FindEntry(IEnumerable<IProperty>, IEnumerable<Object>)	Zwraca element EntityEntry<TEntity> dla pierwszej jednostki śledzonej przez kontekst, w którym wartość danej właściwości jest zgodna z podanymi wartościami. Wpis zapewnia dostęp do informacji i operacji śledzenia zmian dla jednostki.
FindEntry(IEnumerable<String>, IEnumerable<Object>)	Zwraca element EntityEntry<TEntity> dla pierwszej jednostki śledzonej przez kontekst, w którym wartość danej właściwości jest zgodna z podanymi wartościami. Wpis zapewnia dostęp do informacji i operacji śledzenia zmian dla jednostki.
FindEntry<TKey>(TKey)	Znajduje element EntityEntry<TEntity> dla jednostki z daną wartością klucza podstawowego w monitorze zmian, jeśli jest śledzony. null jest zwracana, jeśli nie jest śledzona żadna jednostka z daną wartością klucza. Ta metoda nigdy nie wysyła zapytań do bazy danych.
FindEntry<TProperty>(IProperty, TProperty)	Zwraca element EntityEntry<TEntity> dla pierwszej jednostki śledzonej przez kontekst, w którym wartość danej właściwości jest zgodna z daną wartością. Wpis zapewnia dostęp do informacji i operacji śledzenia zmian dla jednostki.
FindEntry<TProperty>(String, TProperty)	Zwraca element EntityEntry<TEntity> dla pierwszej jednostki śledzonej przez kontekst, w którym wartość danej właściwości jest zgodna z daną wartością. Wpis zapewnia dostęp do informacji i operacji śledzenia zmian dla jednostki.
FindEntryUntyped(IEnumerable<Object>)	Znajduje element EntityEntry<TEntity> dla jednostki z podanymi wartościami klucza podstawowego w monitorze zmian, jeśli jest śledzony. null jest zwracana, jeśli nie jest śledzona żadna jednostka z podanymi wartościami klucza. Ta metoda nigdy nie wysyła zapytań do bazy danych.
GetEntries(IEnumerable<IProperty>, IEnumerable<Object>)	Zwraca element EntityEntry dla każdej jednostki śledzonej przez kontekst, w którym wartości danej właściwości są zgodne z podanymi wartościami. Wpisy zapewniają dostęp do informacji i operacji śledzenia zmian dla każdej jednostki.
GetEntries(IEnumerable<String>, IEnumerable<Object>)	Zwraca element EntityEntry dla każdej jednostki śledzonej przez kontekst, w którym wartości danej właściwości są zgodne z podanymi wartościami. Wpisy zapewniają dostęp do informacji i operacji śledzenia zmian dla każdej jednostki.
GetEntries<TProperty>(IProperty, TProperty)	Zwraca element EntityEntry<TEntity> dla każdej jednostki śledzonej przez kontekst, w którym wartość danej właściwości jest zgodna z daną wartością. Wpisy zapewniają dostęp do informacji i operacji śledzenia zmian dla każdej jednostki.
GetEntries<TProperty>(String, TProperty)	Zwraca element EntityEntry<TEntity> dla każdej jednostki śledzonej przez kontekst, w którym wartość danej właściwości jest zgodna z daną wartością. Wpisy zapewniają dostęp do informacji i operacji śledzenia zmian dla każdej jednostki.
GetEnumerator()	Zwraca wartość dla IEnumerator<T> wszystkich śledzonych jednostek typu TEntity, które nie są oznaczone jako usunięte.
OnCollectionChanged(NotifyCollectionChangedEventArgs)	CollectionChanged Zgłasza zdarzenie.
OnPropertyChanged(PropertyChangedEventArgs)	PropertyChanged Zgłasza zdarzenie.
OnPropertyChanging(PropertyChangingEventArgs)	PropertyChanging Zgłasza zdarzenie.
Remove(TEntity)	Oznacza daną jednostkę jako Deleted.
Reset()	Resetuje ten widok, czyszcząc wszystkie IBindingList utworzone za ToBindingList() pomocą polecenia i wszystkie ObservableCollection<T> utworzone za pomocą ToObservableCollection()polecenia , oraz czyszcząc wszystkie zdarzenia zarejestrowane w PropertyChangedobiekcie , PropertyChanginglub CollectionChanged.
ToBindingList()	Zwraca implementację BindingList<T> , która pozostaje zsynchronizowana z tą kolekcją. Użyj tego dla powiązania danych WinForms.
ToObservableCollection()	Zwraca implementację ObservableCollection<T> , która pozostaje zsynchronizowana z tą kolekcją. Użyj tego dla powiązania danych WPF.

Zdarzenia

CollectionChanged	Występuje, gdy zawartość kolekcji ulegnie zmianie, ponieważ jednostka została bezpośrednio dodana lub usunięta z kolekcji albo dlatego, że jednostka zaczyna być śledzona, albo ponieważ jednostka jest oznaczona jako Usunięta.
PropertyChanged	Występuje, gdy właściwość tej kolekcji (na przykład Count) zmienia się.
PropertyChanging	Występuje, gdy właściwość tej kolekcji (na przykład Count) zmienia się.

Jawne implementacje interfejsu

IEnumerable.GetEnumerator()	Zwraca wartość dla IEnumerator<T> wszystkich śledzonych jednostek typu TEntity, które nie są oznaczone jako usunięte.
IListSource.ContainsListCollection	Pobiera wartość wskazującą, czy kolekcja jest kolekcją obiektów System.Collections.IList. Zawsze zwraca wartość false.
IListSource.GetList()	Ta metoda jest wywoływana przez struktury powiązań danych podczas próby powiązania danych bezpośrednio z elementem LocalView<TEntity>.