LocalView<TEntity> Classe

  • Referência

Definição

Namespace:
Microsoft.EntityFrameworkCore.ChangeTracking
Assembly:
Microsoft.EntityFrameworkCore.dll
Pacote:
Microsoft.EntityFrameworkCore v1.1.6
Pacote:
Microsoft.EntityFrameworkCore v2.0.3
Pacote:
Microsoft.EntityFrameworkCore v2.1.11
Pacote:
Microsoft.EntityFrameworkCore v2.2.6
Pacote:
Microsoft.EntityFrameworkCore v3.0.0
Pacote:
Microsoft.EntityFrameworkCore v3.1.0
Pacote:
Microsoft.EntityFrameworkCore v5.0.0
Pacote:
Microsoft.EntityFrameworkCore v6.0.0
Pacote:
Microsoft.EntityFrameworkCore v7.0.0
Pacote:
Microsoft.EntityFrameworkCore v8.0.0

Uma coleção que permanece em sincronia com entidades de um determinado tipo que estão sendo controladas por um DbContext. Chame Local para obter uma exibição local.

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

Parâmetros de tipo

TEntity

O tipo da entidade na exibição local.

Herança
Object
LocalView<TEntity>
Implementações
ICollection<TEntity> IEnumerable<T> IEnumerable<TEntity> IEnumerable INotifyCollectionChanged INotifyPropertyChanged INotifyPropertyChanging IListSource

Comentários

Essa exibição local permanecerá em sincronia à medida que as entidades forem adicionadas ou removidas do contexto. Da mesma forma, as entidades adicionadas ou removidas do modo de exibição local serão automaticamente adicionadas ou removidas do contexto.

Adicionar uma entidade a essa coleção fará com que ela seja rastreada no Added estado pelo contexto, a menos que ela já esteja sendo rastreada.

Remover uma entidade dessa coleção fará com que ela seja marcada como Deleted, a menos que tenha sido anteriormente no estado Adicionado, nesse caso, ela será desanexada do contexto.

A coleção implementa INotifyCollectionChanged, INotifyPropertyChanginge INotifyPropertyChanging de modo que as notificações sejam geradas quando uma entidade começa a ser controlada pelo contexto ou é marcada como Deleted ou Detached.

Não use esse tipo diretamente para associação de dados. Em vez disso, chame ToObservableCollection() para associação WPF ou ToBindingList() para WinForms.

Consulte Exibições locais de entidades controladas no EF Core para obter mais informações e exemplos.

Construtores

LocalView<TEntity>(DbSet<TEntity>)

Essa é uma API interna que dá suporte à infraestrutura do Entity Framework Core e não está sujeita aos mesmos padrões de compatibilidade que as APIs públicas. Ele pode ser alterado ou removido sem aviso prévio em qualquer versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que fazer isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.

Propriedades

Count

O número de entidades do tipo TEntity que estão sendo rastreadas e não estão marcadas como Excluídas.
IsReadOnly

False, já que a coleção não é somente leitura.

Métodos

Add(TEntity)

Adiciona uma nova entidade ao DbContext. Se a entidade não estiver sendo rastreada ou estiver marcada como excluída no momento, ela será rastreada como Added.
Clear()

Marca todas as entidades do tipo TEntity que estão sendo rastreadas pelo DbContext como Deleted.
Contains(TEntity)

Retornará true se a entidade estiver sendo controlada pelo contexto e não tiver sido marcada como Excluída.
CopyTo(TEntity[], Int32)

Copia para uma matriz todas as entidades do tipo TEntity que estão sendo rastreadas e não são marcadas como Excluídas.
FindEntry(IEnumerable<IProperty>, IEnumerable<Object>)

Retorna um EntityEntry<TEntity> para a primeira entidade que está sendo controlada pelo contexto em que o valor da propriedade fornecida corresponde aos valores fornecidos. A entrada fornece acesso a informações e operações de controle de alterações para a entidade.
FindEntry(IEnumerable<String>, IEnumerable<Object>)

Retorna um EntityEntry<TEntity> para a primeira entidade que está sendo controlada pelo contexto em que o valor da propriedade fornecida corresponde aos valores fornecidos. A entrada fornece acesso a informações e operações de controle de alterações para a entidade.
FindEntry<TKey>(TKey)

Localiza um EntityEntry<TEntity> para a entidade com o valor de chave primária fornecido no rastreador de alterações, se ele estiver sendo rastreado. null será retornado se nenhuma entidade com o valor de chave fornecido estiver sendo controlada. Esse método nunca consulta o banco de dados.
FindEntry<TProperty>(IProperty, TProperty)

Retorna um EntityEntry<TEntity> para a primeira entidade que está sendo controlada pelo contexto em que o valor da propriedade fornecida corresponde ao valor fornecido. A entrada fornece acesso a informações e operações de controle de alterações para a entidade.
FindEntry<TProperty>(String, TProperty)

Retorna um EntityEntry<TEntity> para a primeira entidade que está sendo controlada pelo contexto em que o valor da propriedade fornecida corresponde ao valor fornecido. A entrada fornece acesso a informações e operações de controle de alterações para a entidade.
FindEntryUntyped(IEnumerable<Object>)

Localiza um EntityEntry<TEntity> para a entidade com os valores de chave primária fornecidos no rastreador de alterações, se ele estiver sendo rastreado. null será retornado se nenhuma entidade com os valores de chave fornecidos estiver sendo controlada. Esse método nunca consulta o banco de dados.
GetEntries(IEnumerable<IProperty>, IEnumerable<Object>)

Retorna um EntityEntry para cada entidade que está sendo controlada pelo contexto em que os valores das propriedades fornecidas correspondem aos valores fornecidos. As entradas fornecem acesso a informações e operações de controle de alterações para cada entidade.
GetEntries(IEnumerable<String>, IEnumerable<Object>)

Retorna um EntityEntry para cada entidade que está sendo controlada pelo contexto em que os valores das propriedades fornecidas correspondem aos valores fornecidos. As entradas fornecem acesso a informações e operações de controle de alterações para cada entidade.
GetEntries<TProperty>(IProperty, TProperty)

Retorna um EntityEntry<TEntity> para cada entidade que está sendo controlada pelo contexto em que o valor da propriedade fornecida corresponde ao valor fornecido. As entradas fornecem acesso a informações e operações de controle de alterações para cada entidade.
GetEntries<TProperty>(String, TProperty)

Retorna um EntityEntry<TEntity> para cada entidade que está sendo controlada pelo contexto em que o valor da propriedade fornecida corresponde ao valor fornecido. As entradas fornecem acesso a informações e operações de controle de alterações para cada entidade.
GetEnumerator()

Retorna um IEnumerator<T> para todas as entidades controladas do tipo TEntity que não estão marcadas como excluídas.
OnCollectionChanged(NotifyCollectionChangedEventArgs)

Aciona o evento CollectionChanged.
OnPropertyChanged(PropertyChangedEventArgs)

Aciona o evento PropertyChanged.
OnPropertyChanging(PropertyChangingEventArgs)

Aciona o evento PropertyChanging.
Remove(TEntity)

Marca a entidade fornecida como Deleted.
Reset()

Redefine essa exibição, limpando qualquer IBindingList criado com ToBindingList() e qualquer ObservableCollection<T> criado com ToObservableCollection()e limpando quaisquer eventos registrados em PropertyChanged, PropertyChangingou CollectionChanged.
ToBindingList()

Retorna uma BindingList<T> implementação que permanece em sincronia com essa coleção. Use isso para associação de dados do WinForms.
ToObservableCollection()

Retorna uma implementação ObservableCollection<T> que permanece em sincronia com essa coleção. Use isso para associação de dados do WPF.

Eventos

CollectionChanged

Ocorre quando o conteúdo da coleção é alterado, porque uma entidade foi adicionada ou removida diretamente da coleção, ou porque uma entidade começa a ser rastreada ou porque uma entidade está marcada como Excluída.
PropertyChanged

Ocorre quando uma propriedade dessa coleção (como Count) é alterada.
PropertyChanging

Ocorre quando uma propriedade dessa coleção (como Count) está sendo alterada.

Implantações explícitas de interface

IEnumerable.GetEnumerator()

Retorna um IEnumerator<T> para todas as entidades controladas do tipo TEntity que não estão marcadas como excluídas.
IListSource.ContainsListCollection

Obtém um valor que indica se a coleção é uma coleção de objetos System.Collections.IList. Sempre retorna false.
IListSource.GetList()

Esse método é chamado por estruturas de associação de dados ao tentar associar dados diretamente a um LocalView<TEntity>.

Aplica-se a