DbContext Classe

Definição

Namespace:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacote:

Microsoft.EntityFrameworkCore v8.0.0

Uma instância DbContext representa uma sessão com o banco de dados e pode ser usada para consultar e salvar instâncias de suas entidades. DbContext é uma combinação dos padrões unidade de trabalho e repositório.

public class DbContext : IAsyncDisposable, IDisposable, Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Internal.IDbContextDependencies, Microsoft.EntityFrameworkCore.Internal.IDbContextPoolable, Microsoft.EntityFrameworkCore.Internal.IDbSetCache

type DbContext = class
    interface IInfrastructure<IServiceProvider>
    interface IDbContextDependencies
    interface IDbSetCache
    interface IDbContextPoolable
    interface IResettableService
    interface IDisposable
    interface IAsyncDisposable

Public Class DbContext
Implements IAsyncDisposable, IDbContextDependencies, IDbContextPoolable, IDbSetCache, IDisposable, IInfrastructure(Of IServiceProvider)

Herança

Object

DbContext

Implementações

IInfrastructure<IServiceProvider> IDisposable Microsoft.EntityFrameworkCore.Internal.IDbContextDependencies Microsoft.EntityFrameworkCore.Internal.IDbContextPoolable Microsoft.EntityFrameworkCore.Internal.IDbSetCache IResettableService IAsyncDisposable

Comentários

O Entity Framework Core não dá suporte a várias operações paralelas que estão sendo executadas na mesma instância DbContext. Isso inclui a execução paralela de consultas assíncronas e qualquer uso simultâneo explícito de vários threads. Portanto, sempre aguarde chamadas assíncronas imediatamente ou use instâncias DbContext separadas para operações executadas em paralelo. Consulte Evitando problemas de threading DbContext para obter mais informações e exemplos.

Normalmente, você cria uma classe que deriva de DbContext e contém DbSet<TEntity> propriedades para cada entidade no modelo. Se as DbSet<TEntity> propriedades tiverem um setter público, elas serão inicializadas automaticamente quando a instância do contexto derivado for criada.

Substitua o OnConfiguring(DbContextOptionsBuilder) método para configurar o banco de dados (e outras opções) a serem usados para o contexto. Como alternativa, se você preferir executar a configuração externamente em vez de embutida em seu contexto, poderá usar (ou DbContextOptionsBuilder) para criar externamente uma instância de DbContextOptions<TContext> (ou DbContextOptions) e passá-la para um construtor base de DbContext.DbContextOptionsBuilder<TContext>

O modelo é descoberto executando um conjunto de convenções sobre as classes de entidade encontradas nas DbSet<TEntity> propriedades no contexto derivado. Para configurar ainda mais o modelo descoberto por convenção, você pode substituir o OnModelCreating(ModelBuilder) método .

Consulte DbContext lifetime, configuration, and initialization, Querying data with EF Core, Changing tracking e Saving data with EF Core para obter mais informações e exemplos.

Construtores

DbContext()	Inicializa uma nova instância da classe DbContext. O OnConfiguring(DbContextOptionsBuilder) método será chamado para configurar o banco de dados (e outras opções) a serem usados para esse contexto.
DbContext(DbContextOptions)	Inicializa uma nova instância da DbContext classe usando as opções especificadas. O OnConfiguring(DbContextOptionsBuilder) método ainda será chamado para permitir uma configuração adicional das opções.

Propriedades

ChangeTracker	Fornece acesso a informações e operações para instâncias de entidade que esse contexto está acompanhando.
ContextId	Um identificador exclusivo para a instância de contexto e a concessão do pool, se houver.
Database	Fornece acesso a informações e operações relacionadas ao banco de dados para esse contexto.
Model	Os metadados sobre a forma das entidades, as relações entre elas e como elas são mapeadas para o banco de dados. Pode não incluir todas as informações necessárias para inicializar o banco de dados.

Métodos

Add(Object)	Começa a acompanhar a entidade especificada e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado em que serão inseridas no banco de dados quando SaveChanges() for chamado.
Add<TEntity>(TEntity)	Começa a acompanhar a entidade especificada e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado em que serão inseridas no banco de dados quando SaveChanges() for chamado.
AddAsync(Object, CancellationToken)	Começa a acompanhar a entidade especificada e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado em que serão inseridas no banco de dados quando SaveChanges() for chamado.
AddAsync<TEntity>(TEntity, CancellationToken)	Começa a acompanhar a entidade especificada e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado em que serão inseridas no banco de dados quando SaveChanges() for chamado.
AddRange(IEnumerable<Object>)	Começa a acompanhar as entidades especificadas e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado de modo que elas sejam inseridas no banco de dados quando SaveChanges() for chamado.
AddRange(Object[])	Começa a acompanhar as entidades especificadas e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado de modo que elas sejam inseridas no banco de dados quando SaveChanges() for chamado.
AddRangeAsync(IEnumerable<Object>, CancellationToken)	Começa a acompanhar a entidade especificada e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado em que serão inseridas no banco de dados quando SaveChanges() for chamado.
AddRangeAsync(Object[])	Começa a acompanhar a entidade especificada e quaisquer outras entidades acessíveis que ainda não estão sendo rastreadas, no Added estado em que serão inseridas no banco de dados quando SaveChanges() for chamado.
Attach(Object)	Começa a acompanhar a entidade especificada e as entradas acessíveis da entidade fornecida usando o Unchanged estado por padrão, mas veja abaixo os casos em que um estado diferente será usado.
Attach<TEntity>(TEntity)	Começa a acompanhar a entidade especificada e as entradas acessíveis da entidade fornecida usando o Unchanged estado por padrão, mas veja abaixo os casos em que um estado diferente será usado.
AttachRange(IEnumerable<Object>)	Começa a acompanhar as entidades e entradas fornecidas acessíveis das entidades fornecidas usando o Unchanged estado por padrão, mas veja abaixo os casos em que um estado diferente será usado.
AttachRange(Object[])	Começa a acompanhar as entidades e entradas fornecidas acessíveis das entidades fornecidas usando o Unchanged estado por padrão, mas veja abaixo os casos em que um estado diferente será usado.
ConfigureConventions(ModelConfigurationBuilder)	Substitua esse método para definir padrões e configurar convenções antes de serem executadas. Esse método é invocado antes OnModelCreating(ModelBuilder)de .
Dispose()	Libera os recursos alocados para esse contexto.
DisposeAsync()	Libera os recursos alocados para esse contexto.
Entry(Object)	Obtém um EntityEntry para a entidade fornecida. A entrada fornece acesso a informações e operações de controle de alterações para a entidade.
Entry<TEntity>(TEntity)	Obtém um EntityEntry<TEntity> para a entidade fornecida. A entrada fornece acesso a informações e operações de controle de alterações para a entidade.
Find(Type, Object[])	Localiza uma entidade com os valores de chave primária fornecidos. Se uma entidade com os valores de chave primária fornecidos estiver sendo controlada pelo contexto, ela será retornada imediatamente sem fazer uma solicitação ao banco de dados. Caso contrário, uma consulta é feita ao banco de dados para uma entidade com os valores de chave primária fornecidos e essa entidade, se encontrada, é anexada ao contexto e retornada. Se nenhuma entidade for encontrada, será retornado nulo.
Find<TEntity>(Object[])	Localiza uma entidade com os valores de chave primária fornecidos. Se uma entidade com os valores de chave primária fornecidos estiver sendo controlada pelo contexto, ela será retornada imediatamente sem fazer uma solicitação ao banco de dados. Caso contrário, uma consulta é feita ao banco de dados para uma entidade com os valores de chave primária fornecidos e essa entidade, se encontrada, é anexada ao contexto e retornada. Se nenhuma entidade for encontrada, será retornado nulo.
FindAsync(Type, Object[])	Localiza uma entidade com os valores de chave primária fornecidos. Se uma entidade com os valores de chave primária fornecidos estiver sendo controlada pelo contexto, ela será retornada imediatamente sem fazer uma solicitação ao banco de dados. Caso contrário, uma consulta é feita ao banco de dados para uma entidade com os valores de chave primária fornecidos e essa entidade, se encontrada, é anexada ao contexto e retornada. Se nenhuma entidade for encontrada, será retornado nulo.
FindAsync(Type, Object[], CancellationToken)	Localiza uma entidade com os valores de chave primária fornecidos. Se uma entidade com os valores de chave primária fornecidos estiver sendo controlada pelo contexto, ela será retornada imediatamente sem fazer uma solicitação ao banco de dados. Caso contrário, uma consulta é feita ao banco de dados para uma entidade com os valores de chave primária fornecidos e essa entidade, se encontrada, é anexada ao contexto e retornada. Se nenhuma entidade for encontrada, será retornado nulo.
FindAsync<TEntity>(Object[])	Localiza uma entidade com os valores de chave primária fornecidos. Se uma entidade com os valores de chave primária fornecidos estiver sendo controlada pelo contexto, ela será retornada imediatamente sem fazer uma solicitação ao banco de dados. Caso contrário, uma consulta é feita ao banco de dados para uma entidade com os valores de chave primária fornecidos e essa entidade, se encontrada, é anexada ao contexto e retornada. Se nenhuma entidade for encontrada, será retornado nulo.
FindAsync<TEntity>(Object[], CancellationToken)	Localiza uma entidade com os valores de chave primária fornecidos. Se uma entidade com os valores de chave primária fornecidos estiver sendo controlada pelo contexto, ela será retornada imediatamente sem fazer uma solicitação ao banco de dados. Caso contrário, uma consulta é feita ao banco de dados para uma entidade com os valores de chave primária fornecidos e essa entidade, se encontrada, é anexada ao contexto e retornada. Se nenhuma entidade for encontrada, será retornado nulo.
FromExpression<TResult>(Expression<Func<IQueryable<TResult>>>)	Cria uma consulta para determinada expressão de consulta.
OnConfiguring(DbContextOptionsBuilder)	Substitua esse método para configurar o banco de dados (e outras opções) a serem usados para esse contexto. Esse método é chamado para cada instância do contexto que é criado. A implementação base não faz nada.
OnModelCreating(ModelBuilder)	Substitua esse método para configurar ainda mais o modelo que foi descoberto por convenção dos tipos de entidade expostos em DbSet<TEntity> propriedades no contexto derivado. O modelo resultante pode ser armazenado em cache e usado novamente para instâncias subsequentes do contexto derivado.
Remove(Object)	Começa a acompanhar a entidade especificada no Deleted estado de modo que ela seja removida do banco de dados quando SaveChanges() for chamada.
Remove<TEntity>(TEntity)	Começa a acompanhar a entidade especificada no Deleted estado de modo que ela seja removida do banco de dados quando SaveChanges() for chamada.
RemoveRange(IEnumerable<Object>)	Começa a acompanhar a entidade especificada no Deleted estado de modo que ela seja removida do banco de dados quando SaveChanges() for chamada.
RemoveRange(Object[])	Começa a acompanhar a entidade especificada no Deleted estado de modo que ela seja removida do banco de dados quando SaveChanges() for chamada.
SaveChanges()	Salva todas as alterações feitas nesse contexto no banco de dados.
SaveChanges(Boolean)	Salva todas as alterações feitas nesse contexto no banco de dados.
SaveChangesAsync(Boolean, CancellationToken)	Salva todas as alterações feitas nesse contexto no banco de dados.
SaveChangesAsync(CancellationToken)	Salva todas as alterações feitas nesse contexto no banco de dados.
Set<TEntity>()	Cria um DbSet<TEntity> que pode ser usado para consultar e salvar instâncias de TEntity.
Set<TEntity>(String)	Cria um DbSet<TEntity> para um tipo de entidade de tipo compartilhado que pode ser usado para consultar e salvar instâncias de TEntity.
Update(Object)	Começa a acompanhar a entidade especificada e as entradas acessíveis da entidade fornecida usando o Modified estado por padrão, mas veja abaixo os casos em que um estado diferente será usado.
Update<TEntity>(TEntity)	Começa a acompanhar a entidade especificada e as entradas acessíveis da entidade fornecida usando o Modified estado por padrão, mas veja abaixo os casos em que um estado diferente será usado.
UpdateRange(IEnumerable<Object>)	Começa a acompanhar as entidades e entradas fornecidas acessíveis das entidades fornecidas usando o Modified estado por padrão, mas veja abaixo os casos em que um estado diferente será usado.
UpdateRange(Object[])	Começa a acompanhar as entidades e entradas fornecidas acessíveis das entidades fornecidas usando o Modified estado por padrão, mas veja abaixo os casos em que um estado diferente será usado.

Eventos

SaveChangesFailed	Um evento acionado se uma chamada para SaveChanges ou SaveChangesAsync falhar com uma exceção.
SavedChanges	Um evento acionado no final de uma chamada para SaveChanges ou SaveChangesAsync
SavingChanges	Um evento acionado no início de uma chamada para SaveChanges ou SaveChangesAsync

Implantações explícitas de interface

IDbContextDependencies.ChangeDetector	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbContextDependencies.EntityFinderFactory	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbContextDependencies.EntityGraphAttacher	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbContextDependencies.ExceptionDetector	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbContextDependencies.InfrastructureLogger	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbContextDependencies.QueryProvider	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbContextDependencies.SetSource	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbContextDependencies.StateManager	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbContextDependencies.UpdateLogger	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbContextPoolable.ClearLease()	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbContextPoolable.SetLease(DbContextLease)	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbContextPoolable.SetLeaseAsync(DbContextLease, CancellationToken)	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbContextPoolable.SnapshotConfiguration()	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbSetCache.GetOrAddSet(IDbSetSource, String, Type)	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbSetCache.GetOrAddSet(IDbSetSource, Type)	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IDbSetCache.GetSets()	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IInfrastructure<IServiceProvider>.Instance	Obtém o escopo IServiceProvider que está sendo usado para resolve serviços. Essa propriedade destina-se ao uso por métodos de extensão que precisam fazer uso de serviços não expostos diretamente na superfície da API pública.
IResettableService.ResetState()	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.
IResettableService.ResetStateAsync(CancellationToken)	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 nenhuma versão. Você só deve usá-lo diretamente em seu código com extrema cautela e saber que isso pode resultar em falhas de aplicativo ao atualizar para uma nova versão do Entity Framework Core.

Métodos de Extensão

GetInfrastructure<T>(IInfrastructure<T>)	Obtém o valor de uma propriedade que está sendo ocultada usando IInfrastructure<T>. Esse método normalmente é usado por provedores de banco de dados (e outras extensões). Geralmente, ele não é usado no código do aplicativo.
CreateProxy(DbContext, Type, Object[])	Cria uma instância de proxy para um tipo de entidade se a criação de proxy tiver sido ativada.
CreateProxy<TEntity>(DbContext, Action<TEntity>, Object[])	Cria uma instância de proxy para um tipo de entidade se a criação de proxy tiver sido ativada.
CreateProxy<TEntity>(DbContext, Object[])	Cria uma instância de proxy para um tipo de entidade se a criação de proxy tiver sido ativada.