LocalView<TEntity> Classe

Definição

Namespace:

Microsoft.EntityFrameworkCore.ChangeTracking

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacote:

Microsoft.EntityFrameworkCore v10.0.0

Origem:

LocalView.cs

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

[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

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

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 no modo de exibição local.

Herança

Object

LocalView<TEntity>

Atributos

NullableAttribute

Implementações

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

Comentários

Esse modo de 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 já esteja sendo controlada.

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

A coleção implementa INotifyCollectionChanged, INotifyPropertyChanginge INotifyPropertyChanging de modo que as notificações são 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() WPF associação ou ToBindingList() para WinForms.

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

Construtores

Nome

Descrição

LocalView<TEntity>(DbSet<TEntity>)

Essa é uma API interna que dá suporte à infraestrutura de 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 Entity Framework Core.

Propriedades

Nome	Descrição
Count	O número de entidades do tipo TEntity que estão sendo controladas e não são marcadas como Excluídas.
IsReadOnly	False, já que a coleção não é somente leitura.

Métodos

Nome	Descrição
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 se tornará controlada como Added.
Clear()	Marca todas as entidades do tipo TEntity que estão sendo rastreadas pelo DbContext como Deleted.
Contains(TEntity)	Retorna 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 controladas 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 determinada 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 determinada 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 uma EntityEntry<TEntity> para a primeira entidade que está sendo controlada pelo contexto em que o valor da propriedade determinada 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 uma EntityEntry<TEntity> para a primeira entidade que está sendo controlada pelo contexto em que o valor da propriedade determinada 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 determinada 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 determinada 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 esse modo de exibição, desmarcando qualquer IBindingList um criado com ToBindingList() e qualquer ObservableCollection<T> um criado com ToObservableCollection(), e desmarcando 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 WinForms.
ToObservableCollection()	Retorna uma implementação ObservableCollection<T> que permanece em sincronia com essa coleção. Use isso para WPF associação de dados.

Eventos

Nome	Descrição
CollectionChanged	Ocorre quando o conteúdo da coleção é alterado, porque uma entidade foi diretamente adicionada ou removida 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

Nome	Descrição
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>.