DbContextOptionsBuilder<TContext> Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona una superficie de API sencilla para configurar DbContextOptions<TContext>. Las bases de datos (y otras extensiones) suelen definir métodos de extensión en este objeto que permiten configurar la conexión de base de datos (y otras opciones) que se usarán para un contexto.
public class DbContextOptionsBuilder<TContext> : Microsoft.EntityFrameworkCore.DbContextOptionsBuilder where TContext : DbContext
type DbContextOptionsBuilder<'Context (requires 'Context :> DbContext)> = class
inherit DbContextOptionsBuilder
Public Class DbContextOptionsBuilder(Of TContext)
Inherits DbContextOptionsBuilder
Parámetros de tipo
- TContext
Tipo de contexto que se va a configurar.
- Herencia
Comentarios
Puede usar DbContextOptionsBuilder para configurar un contexto reemplazando OnConfiguring(DbContextOptionsBuilder) o creando un elemento DbContextOptions externamente y pasándolo al constructor de contexto.
Consulte Uso de DbContextOptions para obtener más información y ejemplos.
Constructores
DbContextOptionsBuilder<TContext>() |
Inicializa una nueva instancia de la DbContextOptionsBuilder<TContext> clase sin ningún conjunto de opciones. |
DbContextOptionsBuilder<TContext>(DbContextOptions<TContext>) |
Inicializa una nueva instancia de la DbContextOptionsBuilder<TContext> clase para configurar aún más un determinado DbContextOptions. |
Propiedades
IsConfigured |
Obtiene un valor que indica si se han configurado opciones. (Heredado de DbContextOptionsBuilder) |
Options |
Obtiene las opciones que se configuran. |
Métodos
AddInterceptors(IEnumerable<IInterceptor>) |
Agrega IInterceptor instancias a las registradas en el contexto. |
AddInterceptors(IEnumerable<IInterceptor>) |
Agrega IInterceptor instancias a las registradas en el contexto. (Heredado de DbContextOptionsBuilder) |
AddInterceptors(IInterceptor[]) |
Agrega IInterceptor instancias a las registradas en el contexto. |
AddInterceptors(IInterceptor[]) |
Agrega IInterceptor instancias a las registradas en el contexto. (Heredado de DbContextOptionsBuilder) |
ConfigureLoggingCacheTime(TimeSpan) |
Configura cuánto tiempo EF Core almacenará en caché la configuración del registro en determinadas rutas de acceso de alto rendimiento. Esto hace que EF Core omita las comprobaciones de registro potencialmente costosas, pero significa que los cambios de registro en tiempo de ejecución (por ejemplo, el registro de un nuevo DiagnosticListener puede no tenerse en cuenta inmediatamente). |
ConfigureLoggingCacheTime(TimeSpan) |
Configura cuánto tiempo EF Core almacenará en caché la configuración del registro en determinadas rutas de acceso de alto rendimiento. Esto hace que EF Core omita las comprobaciones de registro potencialmente costosas, pero significa que los cambios de registro en tiempo de ejecución (por ejemplo, el registro de un nuevo DiagnosticListener puede no tenerse en cuenta inmediatamente). (Heredado de DbContextOptionsBuilder) |
ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Configura el comportamiento en tiempo de ejecución de las advertencias generadas por Entity Framework. Puede establecer un comportamiento y comportamientos predeterminados para cada tipo de advertencia. |
ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Configura el comportamiento en tiempo de ejecución de las advertencias generadas por Entity Framework. Puede establecer un comportamiento y comportamientos predeterminados para cada tipo de advertencia. |
ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Configura el comportamiento en tiempo de ejecución de las advertencias generadas por Entity Framework. Puede establecer un comportamiento y comportamientos predeterminados para cada tipo de advertencia. (Heredado de DbContextOptionsBuilder) |
ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Configura el comportamiento en tiempo de ejecución de las advertencias generadas por Entity Framework. Puede establecer un comportamiento y comportamientos predeterminados para cada tipo de advertencia. (Heredado de DbContextOptionsBuilder) |
EnableDetailedErrors(Boolean) |
Habilita errores detallados al controlar excepciones de valor de datos que se producen durante el procesamiento de los resultados de la consulta del almacén. Estos errores suelen producirse debido a errores de configuración de las propiedades de entidad. Por ejemplo, si una propiedad está configurada para ser de tipo 'int', pero los datos subyacentes del almacén son realmente de tipo 'string', se generará una excepción en tiempo de ejecución durante el procesamiento del valor de datos. Cuando se habilita esta opción y se encuentra un error de datos, la excepción generada incluirá detalles de la propiedad de entidad específica que generó el error. |
EnableDetailedErrors(Boolean) |
Habilita errores detallados al controlar excepciones de valor de datos que se producen durante el procesamiento de los resultados de la consulta del almacén. Estos errores suelen producirse debido a errores de configuración de las propiedades de entidad. Por ejemplo, si una propiedad está configurada para ser de tipo 'int', pero los datos subyacentes del almacén son realmente de tipo 'string', se generará una excepción en tiempo de ejecución durante el procesamiento del valor de datos. Cuando se habilita esta opción y se encuentra un error de datos, la excepción generada incluirá detalles de la propiedad de entidad específica que generó el error. (Heredado de DbContextOptionsBuilder) |
EnableSensitiveDataLogging() |
Permite que los datos de la aplicación se incluyan en mensajes de excepción, registro, etc. Esto puede incluir los valores asignados a las propiedades de las instancias de entidad, los valores de parámetro para los comandos que se envían a la base de datos y otros datos de este tipo. Solo debe habilitar esta marca si tiene las medidas de seguridad adecuadas en función de la confidencialidad de estos datos. |
EnableSensitiveDataLogging() |
Permite que los datos de la aplicación se incluyan en mensajes de excepción, registro, etc. Esto puede incluir los valores asignados a las propiedades de las instancias de entidad, los valores de parámetro para los comandos que se envían a la base de datos y otros datos de este tipo. Solo debe habilitar esta marca si tiene las medidas de seguridad adecuadas en función de la confidencialidad de estos datos. (Heredado de DbContextOptionsBuilder) |
EnableSensitiveDataLogging(Boolean) |
Permite que los datos de la aplicación se incluyan en mensajes de excepción, registro, etc. Esto puede incluir los valores asignados a las propiedades de las instancias de entidad, los valores de parámetro para los comandos que se envían a la base de datos y otros datos de este tipo. Solo debe habilitar esta marca si tiene las medidas de seguridad adecuadas en función de la confidencialidad de estos datos. |
EnableSensitiveDataLogging(Boolean) |
Permite que los datos de la aplicación se incluyan en mensajes de excepción, registro, etc. Esto puede incluir los valores asignados a las propiedades de las instancias de entidad, los valores de parámetro para los comandos que se envían a la base de datos y otros datos de este tipo. Solo debe habilitar esta marca si tiene las medidas de seguridad adecuadas en función de la confidencialidad de estos datos. (Heredado de DbContextOptionsBuilder) |
EnableServiceProviderCaching(Boolean) |
Habilita o deshabilita el almacenamiento en caché de proveedores de servicios internos. La deshabilitación del almacenamiento en caché puede afectar enormemente al rendimiento y solo debe usarse en escenarios de prueba que compilan muchos proveedores de servicios para el aislamiento de prueba. |
EnableServiceProviderCaching(Boolean) |
Habilita o deshabilita el almacenamiento en caché de proveedores de servicios internos. La deshabilitación del almacenamiento en caché puede afectar enormemente al rendimiento y solo debe usarse en escenarios de prueba que compilan muchos proveedores de servicios para el aislamiento de prueba. (Heredado de DbContextOptionsBuilder) |
EnableThreadSafetyChecks(Boolean) |
Deshabilita la detección de simultaneidad, que detecta muchos casos de uso simultáneo erróneo de una DbContext instancia y hace que se produzca una excepción informativa. Esto proporciona una mejora de rendimiento menor, pero si se usa una DbContext instancia simultáneamente, el comportamiento no se definirá y el programa puede producir errores de maneras impredecibles. |
EnableThreadSafetyChecks(Boolean) |
Deshabilita la detección de simultaneidad, que detecta muchos casos de uso simultáneo erróneo de una DbContext instancia y hace que se produzca una excepción informativa. Esto proporciona una mejora de rendimiento menor, pero si se usa una DbContext instancia simultáneamente, el comportamiento no se definirá y el programa puede producir errores de maneras impredecibles. (Heredado de DbContextOptionsBuilder) |
LogTo(Action<String>, Func<EventId,LogLevel,Boolean>, Nullable<DbContextLoggerOptions>) |
Registra eventos filtrados por un delegado de filtro personalizado proporcionado. El filtro debe devolver true para registrar un mensaje o false para filtrarlo fuera del registro. |
LogTo(Action<String>, Func<EventId,LogLevel,Boolean>, Nullable<DbContextLoggerOptions>) |
Registra eventos filtrados por un delegado de filtro personalizado proporcionado. El filtro debe devolver true para registrar un mensaje o false para filtrarlo fuera del registro. (Heredado de DbContextOptionsBuilder) |
LogTo(Action<String>, IEnumerable<EventId>, LogLevel, Nullable<DbContextLoggerOptions>) |
Registra los eventos especificados mediante la acción proporcionada. Por ejemplo, use |
LogTo(Action<String>, IEnumerable<EventId>, LogLevel, Nullable<DbContextLoggerOptions>) |
Registra los eventos especificados mediante la acción proporcionada. Por ejemplo, use |
LogTo(Action<String>, IEnumerable<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Registra todos los eventos de las categorías especificadas mediante la acción proporcionada. Por ejemplo, use |
LogTo(Action<String>, IEnumerable<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Registra todos los eventos de las categorías especificadas mediante la acción proporcionada. Por ejemplo, use |
LogTo(Action<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Registra con la acción proporcionada. Por ejemplo, use |
LogTo(Action<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Registra con la acción proporcionada. Por ejemplo, use |
LogTo(Func<EventId,LogLevel,Boolean>, Action<EventData>) |
Registra eventos en un delegado de registrador personalizado filtrado por un delegado de filtro personalizado. El filtro debe devolver true para registrar un mensaje o false para filtrarlo fuera del registro. |
LogTo(Func<EventId,LogLevel,Boolean>, Action<EventData>) |
Registra eventos en un delegado de registrador personalizado filtrado por un delegado de filtro personalizado. El filtro debe devolver true para registrar un mensaje o false para filtrarlo fuera del registro. (Heredado de DbContextOptionsBuilder) |
ReplaceService<TService,TCurrentImplementation,TNewImplementation>() |
Reemplaza la implementación interna de Entity Framework de una implementación específica de un contrato de servicio por una implementación diferente. |
ReplaceService<TService,TCurrentImplementation,TNewImplementation>() |
Reemplaza la implementación interna de Entity Framework de una implementación específica de un contrato de servicio por una implementación diferente. (Heredado de DbContextOptionsBuilder) |
ReplaceService<TService,TImplementation>() |
Reemplaza todas las implementaciones internas de Entity Framework de un contrato de servicio por una implementación diferente. |
ReplaceService<TService,TImplementation>() |
Reemplaza todas las implementaciones internas de Entity Framework de un contrato de servicio por una implementación diferente. (Heredado de DbContextOptionsBuilder) |
UseApplicationServiceProvider(IServiceProvider) |
Establece a partir del IServiceProvider cual se obtendrán los servicios de aplicación. Esto se hace automáticamente cuando se usa "AddDbContext", por lo que es raro que se deba llamar a este método. |
UseApplicationServiceProvider(IServiceProvider) |
Establece a partir del IServiceProvider cual se obtendrán los servicios de aplicación. Esto se hace automáticamente cuando se usa "AddDbContext" o "AddDbContextPool", por lo que es raro que se deba llamar a este método. (Heredado de DbContextOptionsBuilder) |
UseInternalServiceProvider(IServiceProvider) |
Establece el objeto desde IServiceProvider el que el contexto debe resolver todos sus servicios. EF creará y administrará un proveedor de servicios si no se especifica ninguno. |
UseLoggerFactory(ILoggerFactory) |
Establece el ILoggerFactory objeto que se usará para crear ILogger instancias para el registro realizado por este contexto. |
UseMemoryCache(IMemoryCache) |
Establece el objeto que se va a usar para el IMemoryCache almacenamiento en caché de consultas en este contexto. |
UseModel(IModel) |
Establece el modelo que se va a usar para el contexto. Si se establece el modelo, OnModelCreating(ModelBuilder) no se ejecutará. |
UseQueryTrackingBehavior(QueryTrackingBehavior) |
Establece el comportamiento de seguimiento de las consultas LINQ que se ejecutan en el contexto. Deshabilitar el seguimiento de cambios es útil para escenarios de solo lectura, ya que evita la sobrecarga de configurar el seguimiento de cambios para cada instancia de entidad. No debe deshabilitar el seguimiento de cambios si desea manipular instancias de entidad y conservar esos cambios en la base de datos mediante SaveChanges(). |
UseQueryTrackingBehavior(QueryTrackingBehavior) |
Establece el comportamiento de seguimiento de las consultas LINQ que se ejecutan en el contexto. Deshabilitar el seguimiento de cambios es útil para escenarios de solo lectura, ya que evita la sobrecarga de configurar el seguimiento de cambios para cada instancia de entidad. No debe deshabilitar el seguimiento de cambios si desea manipular instancias de entidad y conservar esos cambios en la base de datos mediante SaveChanges(). (Heredado de DbContextOptionsBuilder) |
UseRootApplicationServiceProvider() |
Resuelve la raíz IServiceProvider desde el proveedor de servicios de aplicaciones con ámbito. El proveedor raíz se puede usar para obtener servicios de aplicación singleton de servicios internos singleton. |
UseRootApplicationServiceProvider() |
Resuelve la raíz IServiceProvider desde el proveedor de servicios de aplicaciones con ámbito. El proveedor raíz se puede usar para obtener servicios de aplicación singleton de servicios internos singleton. (Heredado de DbContextOptionsBuilder) |
UseRootApplicationServiceProvider(IServiceProvider) |
Establece la raíz IServiceProvider desde la que se pueden obtener los servicios de aplicación singleton de los servicios internos singleton. |
UseRootApplicationServiceProvider(IServiceProvider) |
Establece la raíz IServiceProvider desde la que se pueden obtener los servicios de aplicación singleton de los servicios internos singleton. (Heredado de DbContextOptionsBuilder) |
Implementaciones de interfaz explícitas
IDbContextOptionsBuilderInfrastructure.AddOrUpdateExtension<TExtension>(TExtension) |
Agrega la extensión dada a las opciones. Si ya existe una extensión del mismo tipo, se reemplazará. (Heredado de DbContextOptionsBuilder) |