Table of Contents

Class EventSourcingBuilderSqlServerExtensions

Namespace
Excalibur.EventSourcing.SqlServer
Assembly
Excalibur.EventSourcing.SqlServer.dll

Extension methods for configuring SQL Server event sourcing on IEventSourcingBuilder.

public static class EventSourcingBuilderSqlServerExtensions
Inheritance
EventSourcingBuilderSqlServerExtensions
Inherited Members

Remarks

These extensions provide fluent provider selection following the canonical CDC builder pattern (see CdcBuilderSqlServerExtensions).

Methods

UseSqlServer(IEventSourcingBuilder, Action<ISqlServerEventSourcingBuilder>)

Configures the event sourcing builder to use SQL Server for event store and snapshot store.

public static IEventSourcingBuilder UseSqlServer(this IEventSourcingBuilder builder, Action<ISqlServerEventSourcingBuilder> configure)

Parameters

builder IEventSourcingBuilder

The event sourcing builder.

configure Action<ISqlServerEventSourcingBuilder>

Configuration action for the SQL Server event sourcing builder.

Returns

IEventSourcingBuilder

The builder for fluent chaining.

Examples

// Connection string
services.AddExcalibur(x => x.AddEventSourcing(es =>
{
    es.UseSqlServer(sql =>
    {
        sql.ConnectionString(configuration.GetConnectionString("EventStore")!)
           .EventStoreSchema("es")
           .SnapshotStoreSchema("es");
    })
    .AddRepository<OrderAggregate, Guid>();
}));

// Named connection string
services.AddExcalibur(x => x.AddEventSourcing(es =>
{
    es.UseSqlServer(sql =>
    {
        sql.ConnectionStringName("EventStore");
    });
}));

// Connection factory (Azure Managed Identity)
services.AddExcalibur(x => x.AddEventSourcing(es =>
{
    es.UseSqlServer(sql =>
    {
        sql.ConnectionFactory(sp =>
        {
            var config = sp.GetRequiredService<IConfiguration>();
            var connStr = config.GetConnectionString("EventStore")!;
            return () => new SqlConnection(connStr);
        });
    });
}));

// Bind from appsettings.json
services.AddExcalibur(x => x.AddEventSourcing(es =>
{
    es.UseSqlServer(sql =>
    {
        sql.BindConfiguration("EventSourcing:SqlServer");
    });
}));

Exceptions

ArgumentNullException

Thrown when builder or configure is null.