AuditedDbContextBuilderExtensions.WithAuditedDbContext<TContext>(DbContextBuilder<TContext>, Action<AuditedDbContextConfigurator>, ServiceLifetime) Method

Allows you to configure the main (business object) and additional (audit history) DbContext objects in WinForms applications with the Audit Trail Module.

Namespace: DevExpress.ExpressApp.ApplicationBuilder

Assembly: DevExpress.ExpressApp.AuditTrail.EFCore.v24.1.dll

NuGet Package: DevExpress.ExpressApp.AuditTrail.EFCore

Declaration

C#

public static IObjectSpaceProviderBuilder<TContext> WithAuditedDbContext<TContext>(
    this DbContextBuilder<TContext> dbContextBuilder,
    Action<AuditedDbContextConfigurator> configureContexts,
    ServiceLifetime dbContextFactoryServiceLifetime = ServiceLifetime.Scoped
)
    where TContext : IXafApplicationBuilder<TContext>, IAccessor<IServiceCollection>

VB.NET

<ExtensionAttribute>
Public Shared Function WithAuditedDbContext(Of TContext As {IXafApplicationBuilder(Of TContext), IAccessor(Of IServiceCollection)})(
    dbContextBuilder As DbContextBuilder(Of TContext),
    configureContexts As Action(Of AuditedDbContextConfigurator),
    dbContextFactoryServiceLifetime As ServiceLifetime = ServiceLifetime.Scoped
) As IObjectSpaceProviderBuilder(Of TContext)

Parameters

Name	Type	Description
dbContextBuilder	DbContextBuilder<TContext>	Allows you to configure DbContext objects.
configureContexts	Action<AuditedDbContextConfigurator>	A delegate that configures DbContext objects.

Optional Parameters

Name	Type	Default	Description
dbContextFactoryServiceLifetime	ServiceLifetime	Scoped	A ServiceLifetime enumeration value that specifies the lifetime of the DbContextFactory service registered by the WithAuditedDbContext method.

Type Parameters

Name	Description
TContext	The IWinApplicationBuilder type.

Returns

Type	Description
IObjectSpaceProviderBuilder<TContext>	Allows you to register and configure Object Space Providers in your application, and chain further provider registrations.

Remarks

The following example demonstrates how to use this method:

File: MySolution.Win\Startup.cs.

C#

using DevExpress.ExpressApp.ApplicationBuilder;
using DevExpress.ExpressApp.Win.ApplicationBuilder;
// ...
public class ApplicationBuilder : IDesignTimeApplicationFactory {
    public static WinApplication BuildApplication(string connectionString) {
        var builder = WinApplication.CreateBuilder();
        builder.UseApplication<MySolutionWindowsFormsApplication>();
        builder.ObjectSpaceProviders
            .AddSecuredEFCore()
            .WithAuditedDbContext(contexts => {
                contexts.Configure<MySolutionDbContext, AuditingDbContext>(
                    (application, businessObjectDbContextOptions) => {
                        // ...
                    },
                    (application, auditHistoryDbContextOptions) => {
                        // ...
                    },
                    options => {
                        // ...
                    });
            });
    }
    // ...
}