CommunityToolkit.Aspire.EventStore 9.7.1-beta.343

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

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
9.7.1-beta.343 34 8/8/2025
9.7.1-beta.342 38 8/7/2025
9.7.1-beta.341 41 8/6/2025
9.7.1-beta.340 43 8/5/2025
9.7.1-beta.339 43 8/5/2025
9.7.0 66 8/1/2025
9.7.0-beta.337 71 8/1/2025
9.7.0-beta.336 78 8/1/2025
9.7.0-beta.335 80 8/1/2025
9.7.0-beta.333 88 7/30/2025
9.6.1-beta.332 88 7/30/2025
9.6.1-beta.331 84 7/30/2025
9.6.1-beta.330 82 7/30/2025
9.6.1-beta.329 87 7/30/2025
9.6.1-beta.328 85 7/29/2025
9.6.1-beta.327 86 7/28/2025
9.6.1-beta.326 85 7/28/2025
9.6.0 149 7/10/2025
9.6.0-beta.324 107 7/10/2025
9.5.1-beta.323 109 7/10/2025
9.5.1-beta.322 111 7/10/2025
9.5.1-beta.321 108 7/10/2025
9.5.1-beta.320 111 7/9/2025
9.5.1-beta.319 113 7/8/2025
9.5.1-beta.318 113 7/2/2025
9.5.1-beta.317 106 6/30/2025
9.5.1-beta.315 109 6/26/2025
9.5.1-beta.314 110 6/23/2025
9.5.1-beta.313 104 6/20/2025
9.5.1-beta.312 104 6/20/2025
9.5.1-beta.311 116 6/18/2025
9.5.1-beta.310 120 6/17/2025
9.5.1-beta.309 107 6/17/2025
9.5.1-beta.308 113 6/17/2025
9.5.1-beta.307 111 6/16/2025
9.5.1-beta.306 266 6/11/2025
9.5.1-beta.305 86 6/7/2025
9.5.1-beta.304 96 6/6/2025
9.5.1-beta.303 113 6/4/2025
9.5.1-beta.302 114 6/4/2025
9.5.1-beta.301 116 6/2/2025
9.5.1-beta.300 127 5/28/2025
9.5.0 243 5/27/2025
9.5.0-beta.299 125 5/27/2025
9.5.0-beta.298 124 5/26/2025
9.5.0-beta.297 71 5/24/2025
9.5.0-beta.296 67 5/24/2025
9.5.0-beta.295 41 5/24/2025
9.4.1-beta.291 113 5/19/2025
9.4.1-beta.289 136 5/16/2025
9.4.1-beta.288 179 5/16/2025
9.4.1-beta.287 179 5/16/2025
9.4.1-beta.286 178 5/16/2025
9.4.1-beta.285 200 5/14/2025
9.4.1-beta.284 211 5/13/2025
9.4.1-beta.283 201 5/12/2025
9.4.1-beta.282 122 5/7/2025
9.4.1-beta.280 112 5/2/2025
9.4.1-beta.279 115 5/2/2025
9.4.1-beta.277 131 4/23/2025
9.4.1-beta.276 132 4/23/2025
9.4.1-beta.275 128 4/23/2025
9.4.1-beta.274 133 4/23/2025
9.4.1-beta.273 128 4/23/2025
9.4.1-beta.272 136 4/23/2025
9.4.1-beta.271 121 4/23/2025
9.4.1-beta.270 149 4/20/2025
9.4.0 1,032 4/20/2025
9.4.0-beta.269 136 4/20/2025
9.4.0-beta.268 134 4/20/2025
9.3.1-beta.267 133 4/20/2025
9.3.1-beta.266 62 4/19/2025
9.3.1-beta.265 159 4/15/2025
9.3.1-beta.264 167 4/15/2025
9.3.1-beta.263 165 4/15/2025
9.3.1-beta.262 164 4/15/2025
9.3.1-beta.260 138 4/10/2025
9.3.1-beta.259 136 4/8/2025
9.3.1-beta.258 135 4/8/2025
9.3.1-beta.257 134 4/8/2025
9.3.1-beta.256 130 4/8/2025
9.3.1-beta.255 130 4/8/2025
9.3.1-beta.254 135 4/8/2025
9.3.1-beta.253 130 4/1/2025
9.3.1-beta.252 106 3/27/2025
9.3.1-beta.250 111 3/27/2025
9.3.1-beta.249 119 3/27/2025
9.3.1-beta.248 108 3/27/2025
9.3.1-beta.247 116 3/27/2025
9.3.1-beta.244 458 3/25/2025
9.3.1-beta.242 453 3/24/2025
9.3.1-beta.241 130 3/19/2025
9.3.0 256 3/19/2025
9.3.0-beta.239 126 3/19/2025
9.2.2-beta.237 131 3/19/2025
9.2.2-beta.236 103 3/14/2025
9.2.2-beta.230 127 3/13/2025
9.2.2-beta.229 125 3/13/2025
9.2.2-beta.228 136 3/11/2025
9.2.2-beta.227 132 3/11/2025
9.2.2-beta.226 136 3/11/2025
9.2.2-beta.225 139 3/11/2025
9.2.2-beta.224 131 3/11/2025
9.2.2-beta.223 138 3/10/2025
9.2.2-beta.222 145 3/10/2025
9.2.2-beta.220 135 3/9/2025
9.2.2-beta.218 133 3/9/2025
9.2.2-beta.217 177 3/7/2025
9.2.2-beta.216 179 3/7/2025
9.2.2-beta.215 183 3/7/2025
9.2.2-beta.214 170 3/5/2025
9.2.2-beta.213 167 3/5/2025
9.2.2-beta.212 170 3/5/2025
9.2.2-beta.211 173 3/4/2025
9.2.2-beta.210 175 3/4/2025
9.2.2-beta.208 76 3/3/2025
9.2.1 187 3/3/2025
9.2.1-beta.207 97 3/2/2025
9.2.1-beta.206 64 3/1/2025
9.2.1-beta.205 64 2/27/2025
9.2.1-beta.204 65 2/26/2025
9.2.1-beta.203 71 2/26/2025
9.2.0 145 2/26/2025
9.2.0-beta.202 63 2/26/2025
9.2.0-beta.201 66 2/26/2025
9.2.0-beta.199 70 2/26/2025
9.2.0-beta.198 63 2/26/2025
9.1.1-beta.197 78 2/25/2025
9.1.1-beta.196 80 2/25/2025
9.1.1-beta.195 62 2/25/2025
9.1.1-beta.194 66 2/25/2025
9.1.1-beta.193 61 2/25/2025
9.1.1-beta.192 72 2/24/2025
9.1.1-beta.191 73 2/24/2025
9.1.1-beta.190 72 2/19/2025
9.1.1-beta.189 66 2/19/2025
9.1.1-beta.188 75 2/19/2025
9.1.1-beta.187 87 2/19/2025
9.1.1-beta.183 85 2/18/2025
9.1.1-beta.182 72 2/18/2025
9.1.1-beta.181 84 2/18/2025
9.1.1-beta.180 82 2/17/2025
9.1.1-beta.178 82 2/17/2025
9.1.1-beta.177 72 2/12/2025
9.1.1-beta.176 84 2/11/2025
9.1.1-beta.175 68 2/11/2025
9.1.1-beta.173 81 2/10/2025
9.1.1-beta.169 72 2/6/2025
9.1.1-beta.168 71 2/5/2025
9.1.1-beta.166 70 2/5/2025
9.1.1-beta.165 62 2/5/2025
9.1.1-beta.164 76 2/3/2025
9.1.1-beta.162 70 2/3/2025
9.1.1-beta.155 72 1/30/2025
9.1.1-beta.154 64 1/30/2025
9.1.1-beta.153 66 1/30/2025
9.1.1-beta.152 58 1/29/2025
9.1.1-beta.150 62 1/29/2025
9.1.1-beta.148 66 1/26/2025
9.1.1-beta.147 66 1/26/2025
9.1.1-beta.146 71 1/23/2025
9.1.1-beta.145 66 1/22/2025
9.1.1-beta.144 73 1/22/2025
9.1.1-beta.142 61 1/22/2025
9.1.1-beta.140 65 1/22/2025
9.1.1-beta.139 70 1/21/2025
9.1.1-beta.138 66 1/20/2025
9.1.1-beta.137 62 1/17/2025
9.1.1-beta.136 63 1/15/2025
9.1.1-beta.135 46 1/15/2025
9.1.1-beta.134 40 1/15/2025
9.1.1-beta.128 51 1/9/2025
9.1.1-beta.127 56 1/9/2025
9.1.1-beta.126 58 1/9/2025
9.1.1-beta.125 59 1/9/2025
9.1.1-beta.124 63 1/9/2025
9.1.0 238 12/12/2024
9.1.0-beta.123 74 1/3/2025
9.1.0-beta.122 79 1/3/2025
9.1.0-beta.121 79 1/2/2025
9.1.0-beta.120 70 12/30/2024
9.1.0-beta.119 72 12/30/2024
9.1.0-beta.118 74 12/30/2024
9.1.0-beta.116 71 12/30/2024
9.1.0-beta.114 65 12/30/2024
9.1.0-beta.113 73 12/30/2024
9.1.0-beta.112 76 12/18/2024
9.1.0-beta.110 72 12/16/2024
9.1.0-beta.109 73 12/12/2024
9.0.1-beta.108 66 12/12/2024
9.0.1-beta.107 72 12/11/2024
9.0.1-beta.106 69 12/12/2024
9.0.1-beta.104 70 12/11/2024
9.0.1-beta.102 80 12/6/2024
9.0.1-beta.99 71 12/6/2024
9.0.1-beta.98 72 12/6/2024
9.0.1-beta.95 72 12/5/2024
9.0.1-beta.94 75 12/5/2024