CommunityToolkit.Aspire.EventStore 9.8.1-beta.410

Prefix Reserved
This is a prerelease version of CommunityToolkit.Aspire.EventStore.
dotnet add package CommunityToolkit.Aspire.EventStore --version 9.8.1-beta.410
                    
NuGet\Install-Package CommunityToolkit.Aspire.EventStore -Version 9.8.1-beta.410
                    
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.410" />
                    
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.410" />
                    
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.410
                    
#r "nuget: CommunityToolkit.Aspire.EventStore, 9.8.1-beta.410"
                    
#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.410
                    
#: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.410&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=CommunityToolkit.Aspire.EventStore&version=9.8.1-beta.410&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.410 96 10/16/2025
9.8.1-beta.408 92 10/16/2025
9.8.1-beta.407 94 10/16/2025
9.8.1-beta.406 101 10/15/2025
9.8.0 662 9/26/2025
9.8.0-beta.405 100 10/15/2025
9.8.0-beta.404 107 10/13/2025
9.8.0-beta.402 122 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 126 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 199 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 147 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 263 8/29/2025
9.7.2-beta.362 164 8/29/2025
9.7.2-beta.361 170 8/29/2025
9.7.2-beta.360 166 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 214 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 103 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 100 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 290 7/10/2025
9.6.0-beta.324 123 7/10/2025
9.5.1-beta.323 137 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 137 7/8/2025
9.5.1-beta.318 127 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 116 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 287 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 124 6/4/2025
9.5.1-beta.301 128 6/2/2025
9.5.1-beta.300 139 5/28/2025
9.5.0 507 5/27/2025
9.5.0-beta.299 148 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 153 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 146 5/7/2025
9.4.1-beta.280 125 5/2/2025
9.4.1-beta.279 127 5/2/2025
9.4.1-beta.277 146 4/23/2025
9.4.1-beta.276 143 4/23/2025
9.4.1-beta.275 153 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 170 4/20/2025
9.4.0 1,460 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 74 4/19/2025
9.3.1-beta.265 185 4/15/2025
9.3.1-beta.264 180 4/15/2025
9.3.1-beta.263 176 4/15/2025
9.3.1-beta.262 193 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 147 4/8/2025
9.3.1-beta.256 157 4/8/2025
9.3.1-beta.255 140 4/8/2025
9.3.1-beta.254 165 4/8/2025
9.3.1-beta.253 142 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 122 3/27/2025
9.3.1-beta.247 136 3/27/2025
9.3.1-beta.244 479 3/25/2025
9.3.1-beta.242 474 3/24/2025
9.3.1-beta.241 152 3/19/2025
9.3.0 295 3/19/2025
9.3.0-beta.239 146 3/19/2025
9.2.2-beta.237 141 3/19/2025
9.2.2-beta.236 132 3/14/2025
9.2.2-beta.230 142 3/13/2025
9.2.2-beta.229 134 3/13/2025
9.2.2-beta.228 153 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 162 3/11/2025
9.2.2-beta.224 141 3/11/2025
9.2.2-beta.223 162 3/10/2025
9.2.2-beta.222 157 3/10/2025
9.2.2-beta.220 148 3/9/2025
9.2.2-beta.218 144 3/9/2025
9.2.2-beta.217 186 3/7/2025
9.2.2-beta.216 203 3/7/2025
9.2.2-beta.215 193 3/7/2025
9.2.2-beta.214 179 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 93 3/3/2025
9.2.1 238 3/3/2025
9.2.1-beta.207 124 3/2/2025
9.2.1-beta.206 74 3/1/2025
9.2.1-beta.205 74 2/27/2025
9.2.1-beta.204 87 2/26/2025
9.2.1-beta.203 93 2/26/2025
9.2.0 177 2/26/2025
9.2.0-beta.202 73 2/26/2025
9.2.0-beta.201 86 2/26/2025
9.2.0-beta.199 89 2/26/2025
9.2.0-beta.198 80 2/26/2025
9.1.1-beta.197 92 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 91 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 74 2/19/2025
9.1.1-beta.188 87 2/19/2025
9.1.1-beta.187 105 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 105 2/17/2025
9.1.1-beta.178 90 2/17/2025
9.1.1-beta.177 97 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 89 2/10/2025
9.1.1-beta.169 82 2/6/2025
9.1.1-beta.168 91 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 76 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 98 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 86 1/20/2025
9.1.1-beta.137 78 1/17/2025
9.1.1-beta.136 81 1/15/2025
9.1.1-beta.135 63 1/15/2025
9.1.1-beta.134 54 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 85 1/9/2025
9.1.0 284 12/12/2024
9.1.0-beta.123 85 1/3/2025
9.1.0-beta.122 104 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 97 12/30/2024
9.1.0-beta.112 84 12/18/2024
9.1.0-beta.110 84 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 81 12/6/2024
9.0.1-beta.95 83 12/5/2024
9.0.1-beta.94 83 12/5/2024