LocalView<TEntity> Classe

Définition

Espace de noms:

Microsoft.EntityFrameworkCore.ChangeTracking

Assembly:

Microsoft.EntityFrameworkCore.dll

Paquet:

Microsoft.EntityFrameworkCore v9.0.0

Source:

LocalView.cs

Collection qui reste synchronisée avec les entités d’un type donné suivies par un DbContext. Appelez Local pour obtenir une vue 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

Paramètres de type

TEntity

Type de l’entité dans la vue locale.

Héritage

Object

LocalView<TEntity>

Implémente

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

Remarques

Cette vue locale reste synchronisée lorsque les entités sont ajoutées ou supprimées du contexte. De même, les entités ajoutées à ou supprimées de la vue locale seront ajoutées ou supprimées automatiquement du contexte.

L’ajout d’une entité à cette collection entraîne son suivi à l’état par le Added contexte, sauf si elle est déjà suivie.

La suppression d’une entité de cette collection entraîne sa marque en tant que Deleted, sauf si elle était précédemment à l’état Ajouté, auquel cas elle sera détachée du contexte.

La collection implémente , INotifyPropertyChanginget INotifyPropertyChanging de telle sorte que des notifications soient générées INotifyCollectionChangedlorsqu’une entité commence à être suivie par le contexte ou qu’elle est marquée comme Deleted ou Detached.

N’utilisez pas ce type directement pour la liaison de données. Au lieu de cela, appelez ToObservableCollection() pour la liaison WPF ou ToBindingList() pour WinForms.

Pour plus d’informations et d’exemples, consultez Vues locales des entités suivies dans EF Core .

Constructeurs

LocalView<TEntity>(DbSet<TEntity>)

Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une extrême prudence et sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’Entity Framework Core.

Propriétés

Count	Nombre d’entités de type TEntity qui font l’objet d’un suivi et qui ne sont pas marquées comme supprimées.
IsReadOnly	False, car la collection n’est pas en lecture seule.

Méthodes

Add(TEntity)	Ajoute une nouvelle entité à .DbContext Si l’entité n’est pas suivie ou est actuellement marquée comme supprimée, elle devient suivie en tant que Added.
Clear()	Marque toutes les entités de type TEntity suivies par le DbContext comme Deleted.
Contains(TEntity)	Retourne true si l’entité est suivie par le contexte et n’a pas été marquée comme supprimée.
CopyTo(TEntity[], Int32)	Copie dans un tableau toutes les entités de type TEntity qui font l’objet d’un suivi et qui ne sont pas marquées comme supprimées.
FindEntry(IEnumerable<IProperty>, IEnumerable<Object>)	Retourne un EntityEntry<TEntity> pour la première entité suivie par le contexte où la valeur de la propriété donnée correspond aux valeurs données. L’entrée donne accès aux informations et opérations de suivi des modifications pour l’entité.
FindEntry(IEnumerable<String>, IEnumerable<Object>)	Retourne un EntityEntry<TEntity> pour la première entité suivie par le contexte où la valeur de la propriété donnée correspond aux valeurs données. L’entrée donne accès aux informations et opérations de suivi des modifications pour l’entité.
FindEntry<TKey>(TKey)	Recherche un EntityEntry<TEntity> pour l’entité avec la valeur de clé primaire donnée dans le suivi des modifications, s’il fait l’objet d’un suivi. null est retourné si aucune entité avec la valeur de clé donnée n’est suivie. Cette méthode n’interroge jamais la base de données.
FindEntry<TProperty>(IProperty, TProperty)	Retourne un EntityEntry<TEntity> pour la première entité suivie par le contexte où la valeur de la propriété donnée correspond à la valeur donnée. L’entrée donne accès aux informations et opérations de suivi des modifications pour l’entité.
FindEntry<TProperty>(String, TProperty)	Retourne un EntityEntry<TEntity> pour la première entité suivie par le contexte où la valeur de la propriété donnée correspond à la valeur donnée. L’entrée donne accès aux informations et opérations de suivi des modifications pour l’entité.
FindEntryUntyped(IEnumerable<Object>)	Recherche un EntityEntry<TEntity> pour l’entité avec les valeurs de clé primaire données dans le suivi des modifications, s’il fait l’objet d’un suivi. null est retourné si aucune entité avec les valeurs de clé spécifiées n’est suivie. Cette méthode n’interroge jamais la base de données.
GetEntries(IEnumerable<IProperty>, IEnumerable<Object>)	Retourne un EntityEntry pour chaque entité suivie par le contexte où les valeurs des propriétés données correspondent aux valeurs données. Les entrées fournissent l’accès aux informations et opérations de suivi des modifications pour chaque entité.
GetEntries(IEnumerable<String>, IEnumerable<Object>)	Retourne un EntityEntry pour chaque entité suivie par le contexte où les valeurs des propriétés données correspondent aux valeurs données. Les entrées fournissent l’accès aux informations et opérations de suivi des modifications pour chaque entité.
GetEntries<TProperty>(IProperty, TProperty)	Retourne un EntityEntry<TEntity> pour chaque entité suivie par le contexte où la valeur de la propriété donnée correspond à la valeur donnée. Les entrées fournissent l’accès aux informations et opérations de suivi des modifications pour chaque entité.
GetEntries<TProperty>(String, TProperty)	Retourne un EntityEntry<TEntity> pour chaque entité suivie par le contexte où la valeur de la propriété donnée correspond à la valeur donnée. Les entrées fournissent l’accès aux informations et opérations de suivi des modifications pour chaque entité.
GetEnumerator()	Retourne un IEnumerator<T> pour toutes les entités suivies de type TEntity qui ne sont pas marquées comme supprimées.
OnCollectionChanged(NotifyCollectionChangedEventArgs)	Déclenche l’événement CollectionChanged.
OnPropertyChanged(PropertyChangedEventArgs)	Déclenche l’événement PropertyChanged.
OnPropertyChanging(PropertyChangingEventArgs)	Déclenche l’événement PropertyChanging.
Remove(TEntity)	Marque l’entité donnée comme Deleted.
Reset()	Réinitialise cette vue, en effaçant tous IBindingList les événements créés avec ToBindingList() et avec ToObservableCollection()ObservableCollection<T> , et en effaçant tous les événements inscrits sur PropertyChanged, PropertyChangingou CollectionChanged.
ToBindingList()	Retourne une BindingList<T> implémentation qui reste synchronisée avec cette collection. Utilisez cette option pour la liaison de données WinForms.
ToObservableCollection()	Retourne une ObservableCollection<T> implémentation qui reste synchronisée avec cette collection. Utilisez cette option pour la liaison de données WPF.

Événements

CollectionChanged	Se produit lorsque le contenu de la collection change, soit parce qu’une entité a été directement ajoutée ou supprimée de la collection, soit parce qu’une entité commence à être suivie, ou parce qu’une entité est marquée comme supprimée.
PropertyChanged	Se produit lorsqu’une propriété de cette collection (telle que Count) change.
PropertyChanging	Se produit lorsqu’une propriété de cette collection (telle que Count) est en cours de modification.

Implémentations d’interfaces explicites

IEnumerable.GetEnumerator()	Retourne un IEnumerator<T> pour toutes les entités suivies de type TEntity qui ne sont pas marquées comme supprimées.
IListSource.ContainsListCollection	Obtient une valeur indiquant si la collection est une collection d’objets System.Collections.IList. Retourne toujours false.
IListSource.GetList()	Cette méthode est appelée par les frameworks de liaison de données lors de la tentative de liaison de données directement à un LocalView<TEntity>.