CommunityToolkit.Aspire.EventStore 9.8.1-beta.413

Prefix Reserved
This is a prerelease version of CommunityToolkit.Aspire.EventStore.
dotnet add package CommunityToolkit.Aspire.EventStore --version 9.8.1-beta.413
                    
NuGet\Install-Package CommunityToolkit.Aspire.EventStore -Version 9.8.1-beta.413
                    
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="CommunityToolkit.Aspire.EventStore" Version="9.8.1-beta.413" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="CommunityToolkit.Aspire.EventStore" Version="9.8.1-beta.413" />
                    
Directory.Packages.props
<PackageReference Include="CommunityToolkit.Aspire.EventStore" />
                    
Project file
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 CommunityToolkit.Aspire.EventStore --version 9.8.1-beta.413
                    
#r "nuget: CommunityToolkit.Aspire.EventStore, 9.8.1-beta.413"
                    
#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 CommunityToolkit.Aspire.EventStore@9.8.1-beta.413
                    
#: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=CommunityToolkit.Aspire.EventStore&version=9.8.1-beta.413&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=CommunityToolkit.Aspire.EventStore&version=9.8.1-beta.413&prerelease
                    
Install as a Cake Tool

CommunityToolkit.Aspire.EventStore

Registers an EventStoreClient in the DI container for connecting to an EventStore.

Getting started

Prerequisites

  • EventStore cluster.

Install the package

Install the .NET Aspire EventStore Client library with NuGet:

dotnet add package CommunityToolkit.Aspire.EventStore

Usage example

In the Program.cs file of your project, call the AddEventStoreClient extension method to register an EventStoreClient for use via the dependency injection container. The method takes a connection name parameter.

builder.AddEventStoreClient("eventstore");

Configuration

The .NET Aspire EventStore Client integration provides multiple options to configure the server connection based on the requirements and conventions of your project.

Use a connection string

When using a connection string from the ConnectionStrings configuration section, you can provide the name of the connection string when calling builder.AddEventStoreClient():

builder.AddEventStoreClient("eventstore");

And then the connection string will be retrieved from the ConnectionStrings configuration section:

{
    "ConnectionStrings": {
        "eventstore": "esdb://localhost:22113?tls=false"
    }
}

Use configuration providers

The .NET Aspire EventStore Client integration supports Microsoft.Extensions.Configuration. It loads the EventStoreSettings from configuration by using the Aspire:EventStore:Client key. Example appsettings.json that configures some of the options:

{
  "Aspire": {
    "EventStore": {
      "Client": {
        "ConnectionString": "esdb://localhost:22113?tls=false",
        "DisableHealthChecks": true
      }
    }
  }
}

Use inline delegates

Also you can pass the Action<EventStoreClientSettings> configureSettings delegate to set up some or all the options inline, for example to set the API key from code:

builder.AddEventStoreClient("eventstore", settings => settings.DisableHealthChecks = true);

AppHost extensions

In your AppHost project, install the CommunityToolkit.Aspire.Hosting.EventStore library with NuGet:

dotnet add package CommunityToolkit.Aspire.Hosting.EventStore

Then, in the Program.cs file of AppHost, register EventStore and consume the connection using the following methods:

var eventstore = builder.AddEventStore("eventstore");

var myService = builder.AddProject<Projects.MyService>()
                       .WithReference(eventstore);

The WithReference method configures a connection in the MyService project named eventstore. In the Program.cs file of MyService, the EventStore connection can be consumed using:

builder.AddEventStoreClient("eventstore");

Then, in your service, inject EventStoreClient and use it to interact with the EventStore API:

public class MyService(EventStoreClient eventStoreClient)
{
    // ...
}

Additional documentation

Feedback & contributing

https://github.com/CommunityToolkit/Aspire

Product 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 is compatible.  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.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on CommunityToolkit.Aspire.EventStore:

Repository Stars
mehdihadeli/food-delivery-microservices
🍔 A practical and cloud-native food delivery microservices, built with .Net Aspire, .Net 9, MassTransit, Domain-Driven Design, CQRS, Vertical Slice Architecture, Event-Driven Architecture, and the latest technologies.
Version Downloads Last Updated
9.8.1-beta.413 22 10/22/2025
9.8.1-beta.410 109 10/16/2025
9.8.1-beta.408 104 10/16/2025
9.8.1-beta.407 108 10/16/2025
9.8.1-beta.406 113 10/15/2025
9.8.0 1,055 9/26/2025
9.8.0-beta.405 110 10/15/2025
9.8.0-beta.404 114 10/13/2025
9.8.0-beta.402 123 9/29/2025
9.8.0-beta.401 116 9/29/2025
9.8.0-beta.399 120 9/26/2025
9.8.0-beta.398 121 9/25/2025
9.8.0-beta.397 120 9/25/2025
9.8.0-beta.395 116 9/24/2025
9.8.0-beta.394 121 9/23/2025
9.8.0-beta.393 122 9/23/2025
9.8.0-beta.392 127 9/23/2025
9.8.0-beta.389 246 9/18/2025
9.8.0-beta.388 257 9/16/2025
9.8.0-beta.386 200 9/15/2025
9.8.0-beta.385 197 9/15/2025
9.8.0-beta.384 50 9/13/2025
9.8.0-beta.376 149 9/8/2025
9.8.0-beta.375 60 9/6/2025
9.8.0-beta.373 140 9/5/2025
9.8.0-beta.372 136 9/4/2025
9.8.0-beta.370 123 9/2/2025
9.8.0-beta.364 118 9/1/2025
9.7.2 264 8/29/2025
9.7.2-beta.362 166 8/29/2025
9.7.2-beta.361 170 8/29/2025
9.7.2-beta.360 168 8/29/2025
9.7.2-beta.359 168 8/28/2025
9.7.2-beta.358 165 8/28/2025
9.7.2-beta.357 164 8/28/2025
9.7.1 216 8/27/2025
9.7.1-beta.355 165 8/27/2025
9.7.1-beta.354 168 8/27/2025
9.7.1-beta.353 165 8/27/2025
9.7.1-beta.352 166 8/27/2025
9.7.1-beta.351 169 8/27/2025
9.7.1-beta.348 140 8/14/2025
9.7.1-beta.344 69 8/10/2025
9.7.1-beta.343 196 8/8/2025
9.7.1-beta.342 199 8/7/2025
9.7.1-beta.341 198 8/6/2025
9.7.1-beta.340 188 8/5/2025
9.7.1-beta.339 186 8/5/2025
9.7.0 201 8/1/2025
9.7.0-beta.337 84 8/1/2025
9.7.0-beta.336 93 8/1/2025
9.7.0-beta.335 93 8/1/2025
9.7.0-beta.333 104 7/30/2025
9.6.1-beta.332 104 7/30/2025
9.6.1-beta.331 97 7/30/2025
9.6.1-beta.330 95 7/30/2025
9.6.1-beta.329 101 7/30/2025
9.6.1-beta.328 107 7/29/2025
9.6.1-beta.327 116 7/28/2025
9.6.1-beta.326 117 7/28/2025
9.6.0 301 7/10/2025
9.6.0-beta.324 123 7/10/2025
9.5.1-beta.323 138 7/10/2025
9.5.1-beta.322 125 7/10/2025
9.5.1-beta.321 124 7/10/2025
9.5.1-beta.320 124 7/9/2025
9.5.1-beta.319 139 7/8/2025
9.5.1-beta.318 128 7/2/2025
9.5.1-beta.317 122 6/30/2025
9.5.1-beta.315 124 6/26/2025
9.5.1-beta.314 122 6/23/2025
9.5.1-beta.313 118 6/20/2025
9.5.1-beta.312 118 6/20/2025
9.5.1-beta.311 131 6/18/2025
9.5.1-beta.310 144 6/17/2025
9.5.1-beta.309 120 6/17/2025
9.5.1-beta.308 125 6/17/2025
9.5.1-beta.307 123 6/16/2025
9.5.1-beta.306 290 6/11/2025
9.5.1-beta.305 99 6/7/2025
9.5.1-beta.304 111 6/6/2025
9.5.1-beta.303 124 6/4/2025
9.5.1-beta.302 125 6/4/2025
9.5.1-beta.301 128 6/2/2025
9.5.1-beta.300 139 5/28/2025
9.5.0 516 5/27/2025
9.5.0-beta.299 150 5/27/2025
9.5.0-beta.298 137 5/26/2025
9.5.0-beta.297 81 5/24/2025
9.5.0-beta.296 79 5/24/2025
9.5.0-beta.295 57 5/24/2025
9.4.1-beta.291 126 5/19/2025
9.4.1-beta.289 155 5/16/2025
9.4.1-beta.288 192 5/16/2025
9.4.1-beta.287 192 5/16/2025
9.4.1-beta.286 195 5/16/2025
9.4.1-beta.285 211 5/14/2025
9.4.1-beta.284 223 5/13/2025
9.4.1-beta.283 213 5/12/2025
9.4.1-beta.282 148 5/7/2025
9.4.1-beta.280 125 5/2/2025
9.4.1-beta.279 128 5/2/2025
9.4.1-beta.277 148 4/23/2025
9.4.1-beta.276 144 4/23/2025
9.4.1-beta.275 154 4/23/2025
9.4.1-beta.274 145 4/23/2025
9.4.1-beta.273 142 4/23/2025
9.4.1-beta.272 153 4/23/2025
9.4.1-beta.271 134 4/23/2025
9.4.1-beta.270 171 4/20/2025
9.4.0 1,467 4/20/2025
9.4.0-beta.269 150 4/20/2025
9.4.0-beta.268 149 4/20/2025
9.3.1-beta.267 146 4/20/2025
9.3.1-beta.266 75 4/19/2025
9.3.1-beta.265 186 4/15/2025
9.3.1-beta.264 183 4/15/2025
9.3.1-beta.263 176 4/15/2025
9.3.1-beta.262 194 4/15/2025
9.3.1-beta.260 149 4/10/2025
9.3.1-beta.259 149 4/8/2025
9.3.1-beta.258 161 4/8/2025
9.3.1-beta.257 148 4/8/2025
9.3.1-beta.256 158 4/8/2025
9.3.1-beta.255 140 4/8/2025
9.3.1-beta.254 166 4/8/2025
9.3.1-beta.253 143 4/1/2025
9.3.1-beta.252 117 3/27/2025
9.3.1-beta.250 126 3/27/2025
9.3.1-beta.249 129 3/27/2025
9.3.1-beta.248 123 3/27/2025
9.3.1-beta.247 137 3/27/2025
9.3.1-beta.244 483 3/25/2025
9.3.1-beta.242 478 3/24/2025
9.3.1-beta.241 153 3/19/2025
9.3.0 296 3/19/2025
9.3.0-beta.239 150 3/19/2025
9.2.2-beta.237 141 3/19/2025
9.2.2-beta.236 133 3/14/2025
9.2.2-beta.230 142 3/13/2025
9.2.2-beta.229 135 3/13/2025
9.2.2-beta.228 155 3/11/2025
9.2.2-beta.227 146 3/11/2025
9.2.2-beta.226 145 3/11/2025
9.2.2-beta.225 166 3/11/2025
9.2.2-beta.224 141 3/11/2025
9.2.2-beta.223 164 3/10/2025
9.2.2-beta.222 157 3/10/2025
9.2.2-beta.220 150 3/9/2025
9.2.2-beta.218 146 3/9/2025
9.2.2-beta.217 186 3/7/2025
9.2.2-beta.216 205 3/7/2025
9.2.2-beta.215 193 3/7/2025
9.2.2-beta.214 181 3/5/2025
9.2.2-beta.213 178 3/5/2025
9.2.2-beta.212 181 3/5/2025
9.2.2-beta.211 183 3/4/2025
9.2.2-beta.210 184 3/4/2025
9.2.2-beta.208 94 3/3/2025
9.2.1 242 3/3/2025
9.2.1-beta.207 125 3/2/2025
9.2.1-beta.206 74 3/1/2025
9.2.1-beta.205 75 2/27/2025
9.2.1-beta.204 89 2/26/2025
9.2.1-beta.203 94 2/26/2025
9.2.0 177 2/26/2025
9.2.0-beta.202 73 2/26/2025
9.2.0-beta.201 87 2/26/2025
9.2.0-beta.199 89 2/26/2025
9.2.0-beta.198 81 2/26/2025
9.1.1-beta.197 96 2/25/2025
9.1.1-beta.196 89 2/25/2025
9.1.1-beta.195 73 2/25/2025
9.1.1-beta.194 74 2/25/2025
9.1.1-beta.193 71 2/25/2025
9.1.1-beta.192 94 2/24/2025
9.1.1-beta.191 84 2/24/2025
9.1.1-beta.190 82 2/19/2025
9.1.1-beta.189 75 2/19/2025
9.1.1-beta.188 87 2/19/2025
9.1.1-beta.187 107 2/19/2025
9.1.1-beta.183 103 2/18/2025
9.1.1-beta.182 93 2/18/2025
9.1.1-beta.181 93 2/18/2025
9.1.1-beta.180 107 2/17/2025
9.1.1-beta.178 90 2/17/2025
9.1.1-beta.177 99 2/12/2025
9.1.1-beta.176 95 2/11/2025
9.1.1-beta.175 77 2/11/2025
9.1.1-beta.173 90 2/10/2025
9.1.1-beta.169 82 2/6/2025
9.1.1-beta.168 94 2/5/2025
9.1.1-beta.166 89 2/5/2025
9.1.1-beta.165 76 2/5/2025
9.1.1-beta.164 85 2/3/2025
9.1.1-beta.162 79 2/3/2025
9.1.1-beta.155 83 1/30/2025
9.1.1-beta.154 73 1/30/2025
9.1.1-beta.153 87 1/30/2025
9.1.1-beta.152 71 1/29/2025
9.1.1-beta.150 77 1/29/2025
9.1.1-beta.148 77 1/26/2025
9.1.1-beta.147 95 1/26/2025
9.1.1-beta.146 97 1/23/2025
9.1.1-beta.145 89 1/22/2025
9.1.1-beta.144 100 1/22/2025
9.1.1-beta.142 73 1/22/2025
9.1.1-beta.140 77 1/22/2025
9.1.1-beta.139 95 1/21/2025
9.1.1-beta.138 88 1/20/2025
9.1.1-beta.137 80 1/17/2025
9.1.1-beta.136 82 1/15/2025
9.1.1-beta.135 65 1/15/2025
9.1.1-beta.134 55 1/15/2025
9.1.1-beta.128 61 1/9/2025
9.1.1-beta.127 68 1/9/2025
9.1.1-beta.126 66 1/9/2025
9.1.1-beta.125 69 1/9/2025
9.1.1-beta.124 86 1/9/2025
9.1.0 287 12/12/2024
9.1.0-beta.123 85 1/3/2025
9.1.0-beta.122 108 1/3/2025
9.1.0-beta.121 90 1/2/2025
9.1.0-beta.120 80 12/30/2024
9.1.0-beta.119 96 12/30/2024
9.1.0-beta.118 99 12/30/2024
9.1.0-beta.116 84 12/30/2024
9.1.0-beta.114 76 12/30/2024
9.1.0-beta.113 99 12/30/2024
9.1.0-beta.112 85 12/18/2024
9.1.0-beta.110 87 12/16/2024
9.1.0-beta.109 84 12/12/2024
9.0.1-beta.108 77 12/12/2024
9.0.1-beta.107 83 12/11/2024
9.0.1-beta.106 80 12/12/2024
9.0.1-beta.104 82 12/11/2024
9.0.1-beta.102 89 12/6/2024
9.0.1-beta.99 81 12/6/2024
9.0.1-beta.98 82 12/6/2024
9.0.1-beta.95 84 12/5/2024
9.0.1-beta.94 84 12/5/2024