Skip to content
Docs Try Aspire

AspireSqlServerEFCoreSqlClientExtensions Methods

Class Methods 2 members
Extension methods for configuring EntityFrameworkCore DbContext to Azure SQL, MS SQL server
AddSqlServerDbContext(IHostApplicationBuilder, string, Action<MicrosoftEntityFrameworkCoreSqlServerSettings>, Action<DbContextOptionsBuilder>) Section titled AddSqlServerDbContext(IHostApplicationBuilder, string, Action<MicrosoftEntityFrameworkCoreSqlServerSettings>, Action<DbContextOptionsBuilder>) extension
Registers the given EntityFrameworkCore.DbContext as a service in the services provided by the builder. Enables db context pooling, retries, health check, logging and telemetry for the EntityFrameworkCore.DbContext.
public static class AspireSqlServerEFCoreSqlClientExtensions
{
public static void AddSqlServerDbContext<TContext>(
this IHostApplicationBuilder builder,
string connectionName,
Action<MicrosoftEntityFrameworkCoreSqlServerSettings>? configureSettings = null,
Action<DbContextOptionsBuilder>? configureDbContextOptions = null)
{
// ...
}
}
builder IHostApplicationBuilder The Hosting.IHostApplicationBuilder to read config from and add services to.
connectionName string A name used to retrieve the connection string from the ConnectionStrings configuration section.
configureSettings Action<MicrosoftEntityFrameworkCoreSqlServerSettings> optional An optional delegate that can be used for customizing options. It's invoked after the settings are read from the configuration.
configureDbContextOptions Action<DbContextOptionsBuilder> optional An optional delegate to configure the EntityFrameworkCore.DbContextOptions for the context.
ArgumentNullException Thrown if mandatory builder is null.
InvalidOperationException Thrown when mandatory MicrosoftEntityFrameworkCoreSqlServerSettings.ConnectionString is not provided.
Reads the configuration from "Aspire:Microsoft:EntityFrameworkCore:SqlServer:{typeof(TContext).Name}" config section, or "Aspire:Microsoft:EntityFrameworkCore:SqlServer" if former does not exist.
EnrichSqlServerDbContext(IHostApplicationBuilder, Action<MicrosoftEntityFrameworkCoreSqlServerSettings>) Section titled EnrichSqlServerDbContext(IHostApplicationBuilder, Action<MicrosoftEntityFrameworkCoreSqlServerSettings>) extension
Configures retries, health check, logging and telemetry for the EntityFrameworkCore.DbContext.
public static class AspireSqlServerEFCoreSqlClientExtensions
{
public static void EnrichSqlServerDbContext<TContext>(
this IHostApplicationBuilder builder,
Action<MicrosoftEntityFrameworkCoreSqlServerSettings>? configureSettings = null)
{
// ...
}
}
builder IHostApplicationBuilder
configureSettings Action<MicrosoftEntityFrameworkCoreSqlServerSettings> optional
ArgumentNullException Thrown if mandatory builder is null.
InvalidOperationException Thrown when mandatory EntityFrameworkCore.DbContext is not registered in DI.