Język

LocalView<TEntity> Klasa

Definicja

Przestrzeń nazw:
Microsoft.EntityFrameworkCore.ChangeTracking
Zestaw:
Microsoft.EntityFrameworkCore.dll
Pakiet:
Microsoft.EntityFrameworkCore v1.1.6
Pakiet:
Microsoft.EntityFrameworkCore v10.0.0
Pakiet:
Microsoft.EntityFrameworkCore v11.0.0
Pakiet:
Microsoft.EntityFrameworkCore v2.0.3
Pakiet:
Microsoft.EntityFrameworkCore v2.1.11
Pakiet:
Microsoft.EntityFrameworkCore v2.2.6
Pakiet:
Microsoft.EntityFrameworkCore v3.0.0
Pakiet:
Microsoft.EntityFrameworkCore v3.1.0
Pakiet:
Microsoft.EntityFrameworkCore v5.0.0
Pakiet:
Microsoft.EntityFrameworkCore v6.0.0
Pakiet:
Microsoft.EntityFrameworkCore v7.0.0
Pakiet:
Microsoft.EntityFrameworkCore v8.0.0
Pakiet:
Microsoft.EntityFrameworkCore v9.0.0
Źródło:
LocalView.cs
Źródło:
LocalView.cs
Źródło:
LocalView.cs
Źródło:
LocalView.cs
Źródło:
LocalView.cs
Źródło:
LocalView.cs
Źródło:
LocalView.cs
Źródło:
LocalView.cs
Źródło:
LocalView.cs
Źródło:
LocalView.cs
Źródło:
LocalView.cs

Kolekcja, która pozostaje zsynchronizowana z jednostkami danego typu śledzonym przez element DbContext. Wywołaj metodę Local w celu uzyskania widoku lokalnego.

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

Parametry typu

TEntity

Typ jednostki w widoku lokalnym.

Dziedziczenie
Object
LocalView<TEntity>
Atrybuty
NullableAttribute
Implementuje
ICollection<TEntity> IEnumerable<T> IEnumerable<TEntity> IEnumerable INotifyCollectionChanged INotifyPropertyChanged INotifyPropertyChanging IListSource

Uwagi

Ten widok lokalny pozostanie zsynchronizowany w miarę dodawania lub usuwania jednostek 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 ona wcześniej w stanie Dodano, w takim przypadku zostanie odłączona od kontekstu.

Kolekcja implementuje INotifyCollectionChangedelement , INotifyPropertyChangingi INotifyPropertyChanging taki, że powiadomienia są generowane, gdy jednostka zaczyna być śledzona przez kontekst lub jest oznaczona jako Deleted lub Detached.

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

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

Konstruktory

Nazwisko Opis
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 wiedząc, że może to spowodować błędy aplikacji podczas aktualizowania do nowej wersji Entity Framework Core.

Właściwości

Nazwisko Opis
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

Nazwisko Opis
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 element DbContext 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 wartość 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 wartość 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 zwracany, jeśli nie jest śledzona żadna jednostka z daną wartością klucza. Ta metoda nigdy nie wykonuje kwerendy bazy danych.
FindEntry<TProperty>(IProperty, TProperty)

Zwraca wartość 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 wartość 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 zwracany, jeśli nie jest śledzona żadna jednostka z podanymi wartościami klucza. Ta metoda nigdy nie wykonuje kwerendy 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 wartość 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 wartość 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 Wywołuje zdarzenie.
OnPropertyChanged(PropertyChangedEventArgs)

PropertyChanged Wywołuje zdarzenie.
OnPropertyChanging(PropertyChangingEventArgs)

PropertyChanging Wywołuje zdarzenie.
Remove(TEntity)

Oznacza daną jednostkę jako Deleted.
Reset()

Resetuje ten widok, czyści wszystkie IBindingList utworzone za pomocą ToBindingList() polecenia i wszystkie ObservableCollection<T> utworzone za pomocą ToObservableCollection()polecenia , oraz czyści 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ą. Ta funkcja służy do tworzenia powiązania danych WPF.

Zdarzenia

Nazwisko Opis
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 zmienia się właściwość tej kolekcji (na przykład Count).
PropertyChanging

Występuje, gdy zmienia się właściwość tej kolekcji (na przykład Count) .

Jawne implementacje interfejsu

Nazwisko Opis
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>.

Dotyczy