LocalView<TEntity> Classe

Definizione

Spazio dei nomi:

Microsoft.EntityFrameworkCore.ChangeTracking

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacchetto:

Microsoft.EntityFrameworkCore v8.0.0

Raccolta che rimane sincronizzata con le entità di un determinato tipo monitorato da un DbContextoggetto . Chiamare Local per ottenere una visualizzazione locale.

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

Parametri di tipo

TEntity

Tipo dell'entità nella visualizzazione locale.

Ereditarietà

Object

LocalView<TEntity>

Implementazioni

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

Commenti

La visualizzazione locale viene sincronizzata man mano che le entità vengono aggiunte o rimosse dal contesto. Analogamente, le entità aggiunte o rimosse dalla visualizzazione locale verranno automaticamente aggiunte o rimosse dal contesto.

L'aggiunta di un'entità Added a questa raccolta causerà la traccia nello stato del contesto, a meno che non sia già tracciata.

La rimozione di un'entità da questa raccolta causerà il contrassegno come Deleted, a meno che non fosse precedentemente nello stato Aggiunto, nel qual caso verrà scollegato dal contesto.

La raccolta implementa INotifyCollectionChanged, INotifyPropertyChanginge INotifyPropertyChanging in modo che le notifiche vengano generate quando un'entità inizia a essere monitorata dal contesto o è contrassegnata come Deleted o Detached.

Non usare questo tipo direttamente per il data binding. Chiamare ToObservableCollection() invece per l'associazione WPF o ToBindingList() per WinForms.

Per altre informazioni ed esempi, vedere Visualizzazioni locali delle entità rilevate in EF Core .

Costruttori

LocalView<TEntity>(DbSet<TEntity>)

Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in nessuna versione. È consigliabile usarlo direttamente nel codice con attenzione estrema e sapere che ciò può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.

Proprietà

Count	Numero di entità di tipo TEntity monitorate e non contrassegnate come Eliminate.
IsReadOnly	False, poiché la raccolta non è di sola lettura.

Metodi

Add(TEntity)	Aggiunge una nuova entità all'oggetto DbContext. Se l'entità non viene monitorata o è attualmente contrassegnata come eliminata, viene rilevata come Added.
Clear()	Contrassegna tutte le entità di tipo TEntity monitorate da DbContext come Deleted.
Contains(TEntity)	Restituisce true se l'entità viene rilevata dal contesto e non è stata contrassegnata come Eliminata.
CopyTo(TEntity[], Int32)	Copia in una matrice tutte le entità di tipo TEntity rilevate e non vengono contrassegnate come Eliminate.
FindEntry(IEnumerable<IProperty>, IEnumerable<Object>)	Restituisce un oggetto EntityEntry<TEntity> per la prima entità monitorata dal contesto in cui il valore della proprietà specificata corrisponde ai valori specificati. La voce fornisce l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per l'entità.
FindEntry(IEnumerable<String>, IEnumerable<Object>)	Restituisce un oggetto EntityEntry<TEntity> per la prima entità monitorata dal contesto in cui il valore della proprietà specificata corrisponde ai valori specificati. La voce fornisce l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per l'entità.
FindEntry<TKey>(TKey)	Trova un EntityEntry<TEntity> oggetto per l'entità con il valore della chiave primaria specificato nel tracker delle modifiche, se viene monitorato. null viene restituito se non viene rilevata alcuna entità con il valore della chiave specificata. Questo metodo non esegue mai query sul database.
FindEntry<TProperty>(IProperty, TProperty)	Restituisce un EntityEntry<TEntity> oggetto per la prima entità monitorata dal contesto in cui il valore della proprietà specificata corrisponde al valore specificato. La voce fornisce l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per l'entità.
FindEntry<TProperty>(String, TProperty)	Restituisce un EntityEntry<TEntity> oggetto per la prima entità monitorata dal contesto in cui il valore della proprietà specificata corrisponde al valore specificato. La voce fornisce l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per l'entità.
FindEntryUntyped(IEnumerable<Object>)	Trova un EntityEntry<TEntity> oggetto per l'entità con i valori di chiave primaria specificati nel tracker delle modifiche, se viene monitorato. null viene restituito se non viene rilevata alcuna entità con i valori chiave specificati. Questo metodo non esegue mai query sul database.
GetEntries(IEnumerable<IProperty>, IEnumerable<Object>)	Restituisce un oggetto EntityEntry per ogni entità monitorata dal contesto in cui i valori delle proprietà specificati corrispondono ai valori specificati. Le voci forniscono l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per ogni entità.
GetEntries(IEnumerable<String>, IEnumerable<Object>)	Restituisce un oggetto EntityEntry per ogni entità monitorata dal contesto in cui i valori delle proprietà specificati corrispondono ai valori specificati. Le voci forniscono l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per ogni entità.
GetEntries<TProperty>(IProperty, TProperty)	Restituisce un oggetto EntityEntry<TEntity> per ogni entità monitorata dal contesto in cui il valore della proprietà specificata corrisponde al valore specificato. Le voci forniscono l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per ogni entità.
GetEntries<TProperty>(String, TProperty)	Restituisce un oggetto EntityEntry<TEntity> per ogni entità monitorata dal contesto in cui il valore della proprietà specificata corrisponde al valore specificato. Le voci forniscono l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per ogni entità.
GetEnumerator()	Restituisce un oggetto IEnumerator<T> per tutte le entità rilevate di tipo TEntity non contrassegnate come eliminate.
OnCollectionChanged(NotifyCollectionChangedEventArgs)	Genera l'evento CollectionChanged.
OnPropertyChanged(PropertyChangedEventArgs)	Genera l'evento PropertyChanged.
OnPropertyChanging(PropertyChangingEventArgs)	Genera l'evento PropertyChanging.
Remove(TEntity)	Contrassegna l'entità specificata come Deleted.
Reset()	Reimposta questa visualizzazione, cancellando eventuali elementi creati con e tutti gli eventi creati con ToObservableCollection()ToBindingList() e ObservableCollection<T> cancellando IBindingList eventuali eventi registrati in PropertyChanged, PropertyChangingo CollectionChanged.
ToBindingList()	Restituisce un'implementazione BindingList<T> che rimane sincronizzata con questa raccolta. Usare questa opzione per l'associazione dati WinForms.
ToObservableCollection()	Restituisce un'implementazione ObservableCollection<T> che rimane sincronizzata con questa raccolta. Usare questa opzione per il data binding WPF.

Eventi

CollectionChanged	Si verifica quando il contenuto della raccolta viene modificato, perché un'entità è stata aggiunta o rimossa direttamente dalla raccolta o perché un'entità inizia a essere monitorata o perché un'entità è contrassegnata come Eliminata.
PropertyChanged	Si verifica quando una proprietà di questa raccolta (ad esempio Count) cambia.
PropertyChanging	Si verifica quando viene modificata una proprietà di questa raccolta, ad esempio Count.

Implementazioni dell'interfaccia esplicita

IEnumerable.GetEnumerator()	Restituisce un oggetto IEnumerator<T> per tutte le entità rilevate di tipo TEntity non contrassegnate come eliminate.
IListSource.ContainsListCollection	Ottiene un valore che indica se l'insieme è una raccolta di oggetti System.Collections.IList. Restituisce sempre false.
IListSource.GetList()	Questo metodo viene chiamato dai framework di data binding quando si tenta di associare dati direttamente a un LocalView<TEntity>oggetto .