TCIS.EventBus.SqlServer
1.0.0-rc.11
This is a prerelease version of TCIS.EventBus.SqlServer.
dotnet add package TCIS.EventBus.SqlServer --version 1.0.0-rc.11
NuGet\Install-Package TCIS.EventBus.SqlServer -Version 1.0.0-rc.11
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="TCIS.EventBus.SqlServer" Version="1.0.0-rc.11" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="TCIS.EventBus.SqlServer" Version="1.0.0-rc.11" />
<PackageReference Include="TCIS.EventBus.SqlServer" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add TCIS.EventBus.SqlServer --version 1.0.0-rc.11
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: TCIS.EventBus.SqlServer, 1.0.0-rc.11"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package TCIS.EventBus.SqlServer@1.0.0-rc.11
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=TCIS.EventBus.SqlServer&version=1.0.0-rc.11&prerelease
#tool nuget:?package=TCIS.EventBus.SqlServer&version=1.0.0-rc.11&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
TCIS.EventBus.SqlServer
The TCIS.EventBus.SqlServer library is a Storage Provider utilizing SQL Server for the Outbox pattern in TCIS.EventBus.
🌟 Features
- Ensures Consistency when publishing messages (Outbox Pattern).
- Native integration through database Transactions.
- Direct and automatic integration into Entity Framework Core.
- Safely stores the send/receive history within CAP tables.
📦 Installation
dotnet add package TCIS.EventBus.SqlServer
🚀 Setup & Usage
1. Registration in Program.cs
Method 1: Using ADO.NET Connection String
using TCIS.EventBus;
using TCIS.EventBus.SqlServer;
builder.Services.AddTEventBus(options =>
{
options.UseSqlServer("Server=...;Database=...;User Id=...;Password=...");
// ... config transport
});
Method 2 (Recommended): Seamless Integration with Entity Framework Core
using TCIS.EventBus;
using TCIS.EventBus.SqlServer;
builder.Services.AddTEventBus(options =>
{
// Share DbContext and Transaction with EF Core
options.UseEntityFramework<MyApplicationDbContext>();
// Or customize with advanced options:
// options.UseEntityFramework<MyApplicationDbContext>(efOptions => { ... });
});
2. Coordinated Transactions (EF Core)
When using UseEntityFramework<TContext>, you can dispatch messages within the same Transaction to ensure data consistency:
using var transaction = await _dbContext.Database.BeginTransactionAsync(_eventPublisher, autoCommit: false);
// Update DB
_dbContext.Orders.Add(order);
await _dbContext.SaveChangesAsync();
// Emit event (Will not be physically sent until the transaction commits)
await _eventPublisher.PublishAsync("order.created", order);
// Commit (DB changes applied + message stored in Outbox table -> Broker sends it in the background)
await transaction.CommitAsync();
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net8.0
- Microsoft.Bcl.Memory (>= 10.0.7)
- Microsoft.Data.SqlClient (>= 5.2.2)
- Microsoft.EntityFrameworkCore (>= 8.0.13)
- Microsoft.EntityFrameworkCore.Relational (>= 8.0.13)
- Microsoft.Extensions.Caching.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Caching.Memory (>= 8.0.1)
- Microsoft.Extensions.Configuration.Abstractions (>= 9.0.0)
- Microsoft.Extensions.DependencyInjection (>= 9.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.0)
- Microsoft.Extensions.Logging (>= 9.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.0)
- Microsoft.Extensions.Options (>= 9.0.0)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.4.0)
- System.IdentityModel.Tokens.Jwt (>= 8.4.0)
- System.Text.Encodings.Web (>= 9.0.0)
- System.Text.Json (>= 9.0.0)
- TCIS.Core (>= 1.0.0-rc.11)
- TCIS.EventBus (>= 1.0.0-rc.11)
- TCIS.Logging.Abstractions (>= 1.0.0-rc.11)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.0-rc.11 | 34 | 7/28/2026 |
| 1.0.0-rc.10 | 46 | 7/24/2026 |
| 1.0.0-rc.9 | 47 | 7/21/2026 |
| 1.0.0-rc.8 | 45 | 7/21/2026 |
| 1.0.0-rc.7 | 49 | 7/17/2026 |
| 1.0.0-rc.6 | 62 | 7/7/2026 |
| 1.0.0-rc.5 | 59 | 7/7/2026 |
| 1.0.0-rc.4 | 64 | 6/24/2026 |
| 1.0.0-rc.2 | 62 | 5/12/2026 |
| 1.0.0-rc.1 | 64 | 5/12/2026 |