DbContext Clase

Definición

Espacio de nombres:

Microsoft.EntityFrameworkCore

Ensamblado:

Microsoft.EntityFrameworkCore.dll

Paquete:

Microsoft.EntityFrameworkCore v8.0.0

Una instancia de DbContext representa una sesión con la base de datos y se puede usar para consultar y guardar instancias de las entidades. DbContext es una combinación de los patrones de unidad de trabajo y repositorio.

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)

Herencia

Object

DbContext

Implementaciones

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

Comentarios

Entity Framework Core no admite la ejecución de varias operaciones paralelas en la misma instancia de DbContext. Esto incluye la ejecución en paralelo de consultas asincrónicas y cualquier uso simultáneo explícito desde varios subprocesos. Por lo tanto, espere siempre llamadas asincrónicas inmediatamente o use instancias de DbContext independientes para las operaciones que se ejecutan en paralelo. Consulte Evitar problemas de subprocesos de DbContext para obtener más información y ejemplos.

Normalmente, se crea una clase que deriva de DbContext y contiene DbSet<TEntity> propiedades para cada entidad del modelo. Si las DbSet<TEntity> propiedades tienen un establecedor público, se inicializan automáticamente cuando se crea la instancia del contexto derivado.

Invalide el OnConfiguring(DbContextOptionsBuilder) método para configurar la base de datos (y otras opciones) que se usará para el contexto. Como alternativa, si prefiere realizar la configuración externamente en lugar de en línea en el contexto, puede usar DbContextOptionsBuilder<TContext> (o DbContextOptionsBuilder) para crear externamente una instancia de DbContextOptions<TContext> (o DbContextOptions) y pasarla a un constructor base de DbContext.

El modelo se detecta mediante la ejecución de un conjunto de convenciones sobre las clases de entidad que se encuentran en las DbSet<TEntity> propiedades del contexto derivado. Para configurar aún más el modelo detectado por convención, puede invalidar el OnModelCreating(ModelBuilder) método .

Consulte Duración, configuración e inicialización de DbContext, Consulta de datos con EF Core, Cambio del seguimiento y Guardado de datos con EF Core para obtener más información y ejemplos.

Constructores

DbContext()	Inicializa una nueva instancia de la clase DbContext. OnConfiguring(DbContextOptionsBuilder) Se llamará al método para configurar la base de datos (y otras opciones) que se usará para este contexto.
DbContext(DbContextOptions)	Inicializa una nueva instancia de la DbContext clase utilizando las opciones especificadas. Se OnConfiguring(DbContextOptionsBuilder) seguirá llamando al método para permitir una configuración adicional de las opciones.

Propiedades

ChangeTracker	Proporciona acceso a la información y las operaciones de las instancias de entidad que este contexto realiza el seguimiento.
ContextId	Identificador único para la instancia de contexto y la concesión del grupo, si existe.
Database	Proporciona acceso a la información y las operaciones relacionadas con la base de datos para este contexto.
Model	Metadatos sobre la forma de las entidades, las relaciones entre ellas y cómo se asignan a la base de datos. Es posible que no incluya toda la información necesaria para inicializar la base de datos.

Métodos

Add(Object)	Comienza a realizar el seguimiento de la entidad dada y a cualquier otra entidad accesible que aún no se esté realizando el seguimiento, en el Added estado para que se inserten en la base de datos cuando SaveChanges() se llame a .
Add<TEntity>(TEntity)	Comienza a realizar el seguimiento de la entidad dada y a cualquier otra entidad accesible que aún no se esté realizando el seguimiento, en el Added estado para que se inserten en la base de datos cuando SaveChanges() se llame a .
AddAsync(Object, CancellationToken)	Comienza a realizar el seguimiento de la entidad dada y a cualquier otra entidad accesible que aún no se esté realizando el seguimiento, en el Added estado para que se inserten en la base de datos cuando SaveChanges() se llame a .
AddAsync<TEntity>(TEntity, CancellationToken)	Comienza a realizar el seguimiento de la entidad dada y a cualquier otra entidad accesible que aún no se esté realizando el seguimiento, en el Added estado para que se inserten en la base de datos cuando SaveChanges() se llame a .
AddRange(IEnumerable<Object>)	Comienza a realizar el seguimiento de las entidades especificadas y a cualquier otra entidad accesible que aún no se esté realizando el seguimiento, en el Added estado para que se inserten en la base de datos cuando SaveChanges() se llame a .
AddRange(Object[])	Comienza a realizar el seguimiento de las entidades especificadas y a cualquier otra entidad accesible que aún no se esté realizando el seguimiento, en el Added estado para que se inserten en la base de datos cuando SaveChanges() se llame a .
AddRangeAsync(IEnumerable<Object>, CancellationToken)	Comienza a realizar el seguimiento de la entidad dada y a cualquier otra entidad accesible que aún no se esté realizando el seguimiento, en el Added estado para que se inserten en la base de datos cuando SaveChanges() se llame a .
AddRangeAsync(Object[])	Comienza a realizar el seguimiento de la entidad dada y a cualquier otra entidad accesible que aún no se esté realizando el seguimiento, en el Added estado para que se inserten en la base de datos cuando SaveChanges() se llame a .
Attach(Object)	Comienza a realizar el seguimiento de la entidad y las entradas especificadas accesibles desde la entidad especificada mediante el Unchanged estado de forma predeterminada, pero consulte a continuación para los casos en los que se usará un estado diferente.
Attach<TEntity>(TEntity)	Comienza a realizar el seguimiento de la entidad y las entradas especificadas accesibles desde la entidad especificada mediante el Unchanged estado de forma predeterminada, pero consulte a continuación para los casos en los que se usará un estado diferente.
AttachRange(IEnumerable<Object>)	Comienza a realizar el seguimiento de las entidades y entradas especificadas accesibles desde las entidades especificadas mediante el Unchanged estado de forma predeterminada, pero consulte a continuación para los casos en los que se usará un estado diferente.
AttachRange(Object[])	Comienza a realizar el seguimiento de las entidades y entradas especificadas accesibles desde las entidades especificadas mediante el Unchanged estado de forma predeterminada, pero consulte a continuación para los casos en los que se usará un estado diferente.
ConfigureConventions(ModelConfigurationBuilder)	Invalide este método para establecer los valores predeterminados y configurar las convenciones antes de que se ejecuten. Este método se invoca antes de OnModelCreating(ModelBuilder).
Dispose()	Libera los recursos asignados para este contexto.
DisposeAsync()	Libera los recursos asignados para este contexto.
Entry(Object)	Obtiene un EntityEntry para la entidad especificada. La entrada proporciona acceso a la información y las operaciones de seguimiento de cambios para la entidad.
Entry<TEntity>(TEntity)	Obtiene un EntityEntry<TEntity> para la entidad especificada. La entrada proporciona acceso a la información y las operaciones de seguimiento de cambios para la entidad.
Find(Type, Object[])	Busca una entidad con los valores de clave principal determinados. Si el contexto realiza un seguimiento de una entidad con los valores de clave principal especificados, se devuelve inmediatamente sin realizar una solicitud a la base de datos. De lo contrario, se realiza una consulta en la base de datos de una entidad con los valores de clave principal especificados y esta entidad, si se encuentra, se adjunta al contexto y se devuelve. Si no se encuentra ninguna entidad, se devuelve null.
Find<TEntity>(Object[])	Busca una entidad con los valores de clave principal determinados. Si el contexto realiza un seguimiento de una entidad con los valores de clave principal especificados, se devuelve inmediatamente sin realizar una solicitud a la base de datos. De lo contrario, se realiza una consulta en la base de datos de una entidad con los valores de clave principal especificados y esta entidad, si se encuentra, se adjunta al contexto y se devuelve. Si no se encuentra ninguna entidad, se devuelve null.
FindAsync(Type, Object[])	Busca una entidad con los valores de clave principal determinados. Si el contexto realiza un seguimiento de una entidad con los valores de clave principal especificados, se devuelve inmediatamente sin realizar una solicitud a la base de datos. De lo contrario, se realiza una consulta en la base de datos de una entidad con los valores de clave principal especificados y esta entidad, si se encuentra, se adjunta al contexto y se devuelve. Si no se encuentra ninguna entidad, se devuelve null.
FindAsync(Type, Object[], CancellationToken)	Busca una entidad con los valores de clave principal determinados. Si el contexto realiza un seguimiento de una entidad con los valores de clave principal especificados, se devuelve inmediatamente sin realizar una solicitud a la base de datos. De lo contrario, se realiza una consulta en la base de datos de una entidad con los valores de clave principal especificados y esta entidad, si se encuentra, se adjunta al contexto y se devuelve. Si no se encuentra ninguna entidad, se devuelve null.
FindAsync<TEntity>(Object[])	Busca una entidad con los valores de clave principal determinados. Si el contexto realiza un seguimiento de una entidad con los valores de clave principal especificados, se devuelve inmediatamente sin realizar una solicitud a la base de datos. De lo contrario, se realiza una consulta en la base de datos de una entidad con los valores de clave principal especificados y esta entidad, si se encuentra, se adjunta al contexto y se devuelve. Si no se encuentra ninguna entidad, se devuelve null.
FindAsync<TEntity>(Object[], CancellationToken)	Busca una entidad con los valores de clave principal determinados. Si el contexto realiza un seguimiento de una entidad con los valores de clave principal especificados, se devuelve inmediatamente sin realizar una solicitud a la base de datos. De lo contrario, se realiza una consulta en la base de datos de una entidad con los valores de clave principal especificados y esta entidad, si se encuentra, se adjunta al contexto y se devuelve. Si no se encuentra ninguna entidad, se devuelve null.
FromExpression<TResult>(Expression<Func<IQueryable<TResult>>>)	Crea una expresión de consulta para una expresión de consulta determinada.
OnConfiguring(DbContextOptionsBuilder)	Invalide este método para configurar la base de datos (y otras opciones) que se usará para este contexto. Se llama a este método para cada instancia del contexto que se crea. La implementación base no hace nada.
OnModelCreating(ModelBuilder)	Invalide este método para configurar aún más el modelo detectado por convención de los tipos de entidad expuestos en DbSet<TEntity> las propiedades del contexto derivado. El modelo resultante se puede almacenar en caché y volver a usarse para las instancias posteriores del contexto derivado.
Remove(Object)	Comienza a realizar un seguimiento de la entidad especificada en el Deleted estado de forma que se quitará de la base de datos cuando SaveChanges() se llame a .
Remove<TEntity>(TEntity)	Comienza a realizar un seguimiento de la entidad especificada en el Deleted estado de forma que se quitará de la base de datos cuando SaveChanges() se llame a .
RemoveRange(IEnumerable<Object>)	Comienza a realizar un seguimiento de la entidad especificada en el Deleted estado de forma que se quitará de la base de datos cuando SaveChanges() se llame a .
RemoveRange(Object[])	Comienza a realizar un seguimiento de la entidad especificada en el Deleted estado de forma que se quitará de la base de datos cuando SaveChanges() se llame a .
SaveChanges()	Guarda todos los cambios realizados en este contexto en la base de datos.
SaveChanges(Boolean)	Guarda todos los cambios realizados en este contexto en la base de datos.
SaveChangesAsync(Boolean, CancellationToken)	Guarda todos los cambios realizados en este contexto en la base de datos.
SaveChangesAsync(CancellationToken)	Guarda todos los cambios realizados en este contexto en la base de datos.
Set<TEntity>()	Crea un DbSet<TEntity> objeto que se puede usar para consultar y guardar instancias de TEntity.
Set<TEntity>(String)	Crea un DbSet<TEntity> para un tipo de entidad de tipo compartido que se puede usar para consultar y guardar instancias de TEntity.
Update(Object)	Comienza a realizar el seguimiento de la entidad y las entradas especificadas accesibles desde la entidad determinada mediante el Modified estado de forma predeterminada, pero consulte a continuación para los casos en los que se usará un estado diferente.
Update<TEntity>(TEntity)	Comienza a realizar el seguimiento de la entidad y las entradas especificadas accesibles desde la entidad determinada mediante el Modified estado de forma predeterminada, pero consulte a continuación para los casos en los que se usará un estado diferente.
UpdateRange(IEnumerable<Object>)	Comienza a realizar el seguimiento de las entidades y entradas especificadas accesibles desde las entidades especificadas mediante el Modified estado de forma predeterminada, pero consulte a continuación para ver los casos en los que se usará un estado diferente.
UpdateRange(Object[])	Comienza a realizar el seguimiento de las entidades y entradas especificadas accesibles desde las entidades especificadas mediante el Modified estado de forma predeterminada, pero consulte a continuación para ver los casos en los que se usará un estado diferente.

Eventos

SaveChangesFailed	Se desencadena un evento si se produce un error en una llamada a SaveChanges o SaveChangesAsync se produce un error con una excepción.
SavedChanges	Un evento desencadenado al final de una llamada a SaveChanges o SaveChangesAsync
SavingChanges	Un evento desencadenado al principio de una llamada a SaveChanges o SaveChangesAsync

Implementaciones de interfaz explícitas

IDbContextDependencies.ChangeDetector	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede dar lugar a errores de aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbContextDependencies.EntityFinderFactory	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede dar lugar a errores de aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbContextDependencies.EntityGraphAttacher	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede dar lugar a errores de aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbContextDependencies.ExceptionDetector	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede dar lugar a errores de aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbContextDependencies.InfrastructureLogger	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede dar lugar a errores de aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbContextDependencies.QueryProvider	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede dar lugar a errores de aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbContextDependencies.SetSource	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede dar lugar a errores de aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbContextDependencies.StateManager	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede dar lugar a errores de aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbContextDependencies.UpdateLogger	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede dar lugar a errores de aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbContextPoolable.ClearLease()	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede dar lugar a errores de aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbContextPoolable.SetLease(DbContextLease)	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede provocar errores en la aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbContextPoolable.SetLeaseAsync(DbContextLease, CancellationToken)	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede provocar errores en la aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbContextPoolable.SnapshotConfiguration()	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede provocar errores en la aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbSetCache.GetOrAddSet(IDbSetSource, String, Type)	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede provocar errores en la aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbSetCache.GetOrAddSet(IDbSetSource, Type)	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede provocar errores en la aplicación al actualizar a una nueva versión de Entity Framework Core.
IDbSetCache.GetSets()	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede provocar errores en la aplicación al actualizar a una nueva versión de Entity Framework Core.
IInfrastructure<IServiceProvider>.Instance	Obtiene el ámbito que IServiceProvider se usa para resolver los servicios. Esta propiedad está pensada para su uso por métodos de extensión que necesitan hacer uso de servicios que no se exponen directamente en la superficie de la API pública.
IResettableService.ResetState()	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede dar lugar a errores de aplicación al actualizar a una nueva versión de Entity Framework Core.
IResettableService.ResetStateAsync(CancellationToken)	Se trata de una API interna que admite la infraestructura de Entity Framework Core y no está sujeta a los mismos estándares de compatibilidad que las API públicas. Se puede cambiar o quitar sin previo aviso en ninguna versión. Solo debe usarlo directamente en el código con extrema precaución y saber que hacerlo puede dar lugar a errores de aplicación al actualizar a una nueva versión de Entity Framework Core.

Métodos de extensión

GetInfrastructure<T>(IInfrastructure<T>)	Obtiene el valor de una propiedad que se oculta mediante IInfrastructure<T>. Normalmente, los proveedores de bases de datos usan este método (y otras extensiones). Por lo general, no se usa en el código de la aplicación.
CreateProxy(DbContext, Type, Object[])	Crea una instancia de proxy para un tipo de entidad si se ha activado la creación del proxy.
CreateProxy<TEntity>(DbContext, Action<TEntity>, Object[])	Crea una instancia de proxy para un tipo de entidad si se ha activado la creación del proxy.
CreateProxy<TEntity>(DbContext, Object[])	Crea una instancia de proxy para un tipo de entidad si se ha activado la creación del proxy.