Sprache

LocalView<TEntity> Klasse

Definition

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

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

Typparameter

TEntity

Der Typ der Entität in der lokalen Ansicht.

Vererbung
LocalView<TEntity>
Attribute
Implementiert

Hinweise

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

Das Hinzufügen einer Entität zu dieser Auflistung bewirkt, dass sie im Added Zustand des Kontexts 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 war zuvor im Zustand "Hinzugefügt", in diesem Fall wird sie vom Kontext getrennt.

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

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

Weitere Informationen und Beispiele finden Sie in lokalen Ansichten von nachverfolgten Entitäten in EF Core .

Konstruktoren

Name Beschreibung
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. Sie kann ohne Vorherige Ankündigung geändert oder entfernt werden. Sie sollten sie nur direkt in Ihrem Code mit äußerster Vorsicht verwenden und wissen, dass dies zu Anwendungsfehlern bei der Aktualisierung auf eine neue Entity Framework Core-Version führen kann.

Eigenschaften

Name Beschreibung
Count

Die Anzahl der Entitäten des Typs TEntity , die nachverfolgt werden und nicht als "Gelöscht" gekennzeichnet sind.

IsReadOnly

False, da die Auflistung nicht schreibgeschützt ist.

Methoden

Name Beschreibung
Add(TEntity)

Fügt der DbContextEntität eine neue Entität hinzu. Wenn die Entität nicht nachverfolgt oder zurzeit als gelöscht markiert ist, wird sie als Addednachverfolgt.

Clear()

Markiert alle Entitäten des Typs TEntity , die DbContext vom Typ "as Deleted" nachverfolgt werden.

Contains(TEntity)

Gibt zurück true , wenn die Entität vom Kontext nachverfolgt und nicht als "Gelöscht" markiert wurde.

CopyTo(TEntity[], Int32)

Kopiert in ein Array, das alle Entitäten des Typs TEntity nachverfolgt und nicht als "Gelöscht" gekennzeichnet sind.

FindEntry(IEnumerable<IProperty>, IEnumerable<Object>)

Gibt eine EntityEntry<TEntity> für die erste Entität zurück, die vom Kontext nachverfolgt wird, wobei der Wert der angegebenen Eigenschaft mit den angegebenen Werten übereinstimmt. Der Eintrag bietet Zugriff auf Informationen und Vorgänge zur Änderungsnachverfolgung 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, wobei der Wert der angegebenen Eigenschaft mit den angegebenen Werten übereinstimmt. Der Eintrag bietet Zugriff auf Informationen und Vorgänge zur Änderungsnachverfolgung 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 Änderungsverfolgung, wenn sie nachverfolgt wird. null wird zurückgegeben, wenn keine Entität mit dem angegebenen Schlüsselwert nachverfolgt wird. Diese Methode fragt die Datenbank nie 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 Informationen und Vorgänge zur Änderungsnachverfolgung 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 Informationen und Vorgänge zur Änderungsnachverfolgung für die Entität.

FindEntryUntyped(IEnumerable<Object>)

Sucht eine EntityEntry<TEntity> Für die Entität mit den angegebenen Primärschlüsselwerten im Änderungstracker, wenn sie nachverfolgt wird. null wird zurückgegeben, wenn keine Entität mit den angegebenen Schlüsselwerten nachverfolgt wird. Diese Methode fragt die Datenbank nie 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 den angegebenen Werten entsprechen. 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 den angegebenen Werten entsprechen. 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 eine 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, räumt alle IBindingList erstellten mit ToBindingList() und alle ObservableCollection<T> erstellten mitToObservableCollection(), und löschen Sie alle Ereignisse, die auf PropertyChanged, oder PropertyChanging.CollectionChanged

ToBindingList()

Gibt eine BindingList<T> Implementierung zurück, die mit dieser Auflistung synchronisiert bleibt. Verwenden Sie diese Für WinForms-Datenbindung.

ToObservableCollection()

Gibt eine ObservableCollection<T> Implementierung zurück, die mit dieser Auflistung synchronisiert bleibt. Verwenden Sie dies für WPF Datenbindung.

Events

Name Beschreibung
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 eine Eigenschaft dieser Auflistung (z Count. B. ) geändert wird.

PropertyChanging

Tritt auf, wenn eine Eigenschaft dieser Auflistung (z Count. B. ) geändert wird.

Explizite Schnittstellenimplementierungen

Name Beschreibung
IEnumerable.GetEnumerator()

Gibt eine 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 Bindung zu binden LocalView<TEntity>.

Gilt für: