LocalView<TEntity> Klasse

Definition

Namespace:

Microsoft.EntityFrameworkCore.ChangeTracking

Assembly:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v8.0.0

Eine Auflistung, die mit Entitäten eines bestimmten Typs synchronisiert bleibt, die von einem DbContextnachverfolgt werden. Rufen Sie auf Local , um eine lokale Ansicht zu erhalten.

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

Typparameter

TEntity

Der Typ der Entität in der lokalen Ansicht.

Vererbung

Object

LocalView<TEntity>

Implementiert

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

Hinweise

Diese lokale Ansicht bleibt synchron, wenn dem Kontext Entitäten hinzugefügt oder Entitäten aus dem Kontext entfernt werden. Ebenso werden Entitäten, die der lokalen Ansicht hinzugefügt oder aus dieser entfernt werden, automatisch dem Kontext hinzugefügt bzw. aus dem Kontext entfernt.

Das Hinzufügen einer Entität zu dieser Auflistung führt dazu, dass sie im Added Zustand vom Kontext nachverfolgt wird, es sei denn, sie wird bereits nachverfolgt.

Wenn Sie eine Entität aus dieser Auflistung entfernen, wird sie als Deletedgekennzeichnet, es sei denn, sie befand sich zuvor im Status Hinzugefügt. In diesem Fall wird sie vom Kontext getrennt.

Die Auflistung implementiert INotifyCollectionChanged, INotifyPropertyChangingund INotifyPropertyChanging so, dass Benachrichtigungen generiert werden, wenn eine Entität vom Kontext nachverfolgt wird oder als Deleted oder Detachedgekennzeichnet ist.

Verwenden Sie diesen Typ nicht direkt für die Datenbindung. Rufen Sie ToObservableCollection() stattdessen für die WPF-Bindung oder ToBindingList() für WinForms auf.

Weitere Informationen und Beispiele finden Sie unter Lokale Ansichten nachverfolgter Entitäten in EF Core .

Konstruktoren

LocalView<TEntity>(DbSet<TEntity>)

Dies ist eine interne API, die die Entity Framework Core-Infrastruktur unterstützt und nicht den gleichen Kompatibilitätsstandards wie öffentliche APIs unterliegt. Es kann ohne vorherige Ankündigung in jeder Version geändert oder entfernt werden. Sie sollten es nur mit äußerster Vorsicht direkt in Ihrem Code verwenden und wissen, dass dies bei der Aktualisierung auf ein neues Entity Framework Core-Release zu Anwendungsfehlern führen kann.

Eigenschaften

Count	Die Anzahl der Entitäten vom Typ TEntity, die nachverfolgt werden und nicht als Gelöscht markiert sind.
IsReadOnly	False, da die Auflistung nicht schreibgeschützt ist.

Methoden

Add(TEntity)	Fügt dem DbContexteine neue Entität hinzu. Wenn die Entität nicht nachverfolgt wird oder derzeit als gelöscht markiert ist, wird sie als Addednachverfolgt.
Clear()	Markiert alle Entitäten vom Typ TEntity, die von nachverfolgt werden, DbContext als Deleted.
Contains(TEntity)	Gibt zurück true , wenn die Entität vom Kontext nachverfolgt wird und nicht als Gelöscht markiert wurde.
CopyTo(TEntity[], Int32)	Kopiert alle Entitäten vom Typ TEntity, die nachverfolgt werden und nicht als Gelöscht markiert sind, in ein Array.
FindEntry(IEnumerable<IProperty>, IEnumerable<Object>)	Gibt eine EntityEntry<TEntity> für die erste Entität zurück, die vom Kontext nachverfolgt wird, in der der Wert der angegebenen Eigenschaft mit den angegebenen Werten übereinstimmt. Der Eintrag bietet Zugriff auf Änderungsnachverfolgungsinformationen und -vorgänge für die Entität.
FindEntry(IEnumerable<String>, IEnumerable<Object>)	Gibt eine EntityEntry<TEntity> für die erste Entität zurück, die vom Kontext nachverfolgt wird, in der der Wert der angegebenen Eigenschaft mit den angegebenen Werten übereinstimmt. Der Eintrag bietet Zugriff auf Änderungsnachverfolgungsinformationen und -vorgänge für die Entität.
FindEntry<TKey>(TKey)	Sucht eine EntityEntry<TEntity> für die Entität mit dem angegebenen Primärschlüsselwert in der Änderungsnachverfolgung, wenn sie nachverfolgt wird. null wird zurückgegeben, wenn keine Entität mit dem angegebenen Schlüsselwert nachverfolgt wird. Diese Methode fragt niemals die Datenbank ab.
FindEntry<TProperty>(IProperty, TProperty)	Gibt eine EntityEntry<TEntity> für die erste Entität zurück, die vom Kontext nachverfolgt wird, wobei der Wert der angegebenen Eigenschaft mit dem angegebenen Wert übereinstimmt. Der Eintrag bietet Zugriff auf Änderungsnachverfolgungsinformationen und -vorgänge für die Entität.
FindEntry<TProperty>(String, TProperty)	Gibt eine EntityEntry<TEntity> für die erste Entität zurück, die vom Kontext nachverfolgt wird, wobei der Wert der angegebenen Eigenschaft mit dem angegebenen Wert übereinstimmt. Der Eintrag bietet Zugriff auf Änderungsnachverfolgungsinformationen und -vorgänge für die Entität.
FindEntryUntyped(IEnumerable<Object>)	Sucht eine EntityEntry<TEntity> für die Entität mit den angegebenen Primärschlüsselwerten in der Änderungsnachverfolgung, wenn sie nachverfolgt wird. null wird zurückgegeben, wenn keine Entität mit den angegebenen Schlüsselwerten nachverfolgt wird. Diese Methode fragt niemals die Datenbank ab.
GetEntries(IEnumerable<IProperty>, IEnumerable<Object>)	Gibt eine EntityEntry für jede Entität zurück, die vom Kontext nachverfolgt wird, in dem die Werte der angegebenen Eigenschaften mit den angegebenen Werten übereinstimmen. Die Einträge bieten Zugriff auf Änderungsnachverfolgungsinformationen und -vorgänge für jede Entität.
GetEntries(IEnumerable<String>, IEnumerable<Object>)	Gibt eine EntityEntry für jede Entität zurück, die vom Kontext nachverfolgt wird, in dem die Werte der angegebenen Eigenschaften mit den angegebenen Werten übereinstimmen. Die Einträge bieten Zugriff auf Änderungsnachverfolgungsinformationen und -vorgänge für jede Entität.
GetEntries<TProperty>(IProperty, TProperty)	Gibt eine EntityEntry<TEntity> für jede Entität zurück, die vom Kontext nachverfolgt wird, wobei der Wert der angegebenen Eigenschaft mit dem angegebenen Wert übereinstimmt. Die Einträge bieten Zugriff auf Änderungsnachverfolgungsinformationen und -vorgänge für jede Entität.
GetEntries<TProperty>(String, TProperty)	Gibt eine EntityEntry<TEntity> für jede Entität zurück, die vom Kontext nachverfolgt wird, wobei der Wert der angegebenen Eigenschaft mit dem angegebenen Wert übereinstimmt. Die Einträge bieten Zugriff auf Änderungsnachverfolgungsinformationen und -vorgänge für jede Entität.
GetEnumerator()	Gibt einen IEnumerator<T> für alle nachverfolgten Entitäten des Typs TEntity zurück, die nicht als gelöscht markiert sind.
OnCollectionChanged(NotifyCollectionChangedEventArgs)	Löst das CollectionChanged-Ereignis aus.
OnPropertyChanged(PropertyChangedEventArgs)	Löst das PropertyChanged-Ereignis aus.
OnPropertyChanging(PropertyChangingEventArgs)	Löst das PropertyChanging-Ereignis aus.
Remove(TEntity)	Markiert die angegebene Entität als Deleted.
Reset()	Setzt diese Ansicht zurück, löscht alle IBindingList mit ToBindingList() und alle ObservableCollection<T> mit erstellten und mit ToObservableCollection()und löscht alle Ereignisse, die unter PropertyChanged, PropertyChangingoder CollectionChangedregistriert sind.
ToBindingList()	Gibt eine BindingList<T> Implementierung zurück, die mit dieser Auflistung synchronisiert bleibt. Verwenden Sie dies für die WinForms-Datenbindung.
ToObservableCollection()	Gibt eine ObservableCollection<T> Implementierung zurück, die mit dieser Auflistung synchronisiert bleibt. Verwenden Sie dies für die WPF-Datenbindung.

Ereignisse

CollectionChanged	Tritt auf, wenn sich der Inhalt der Auflistung ändert, entweder weil eine Entität direkt hinzugefügt oder aus der Auflistung entfernt wurde, oder weil eine Entität mit der Nachverfolgung beginnt oder weil eine Entität als Gelöscht markiert ist.
PropertyChanged	Tritt auf, wenn sich eine Eigenschaft dieser Auflistung (z Count. B. ) ändert.
PropertyChanging	Tritt auf, wenn sich eine Eigenschaft dieser Auflistung (z Count. B. ) ändert.

Explizite Schnittstellenimplementierungen

IEnumerable.GetEnumerator()	Gibt einen IEnumerator<T> für alle nachverfolgten Entitäten des Typs TEntity zurück, die nicht als gelöscht markiert sind.
IListSource.ContainsListCollection	Ruft einen Wert ab, der angibt, ob die Auflistung eine Auflistung von System.Collections.IList-Objekten ist. Gibt immer false zurück.
IListSource.GetList()	Diese Methode wird von Datenbindungsframeworks aufgerufen, wenn versucht wird, Daten direkt an eine LocalView<TEntity>zu binden.