CancellationProvider 1.0.0
dotnet add package CancellationProvider --version 1.0.0
NuGet\Install-Package CancellationProvider -Version 1.0.0
<PackageReference Include="CancellationProvider" Version="1.0.0" />
paket add CancellationProvider --version 1.0.0
#r "nuget: CancellationProvider, 1.0.0"
// Install CancellationProvider as a Cake Addin #addin nuget:?package=CancellationProvider&version=1.0.0 // Install CancellationProvider as a Cake Tool #tool nuget:?package=CancellationProvider&version=1.0.0
CancellationProvider ![NuGet Status](https://img.shields.io/nuget/v/CancellationProvider.svg?style=flat)
CancellationProvider is a tiny .NET library to facilitate the flow of CancellationToken
through your code.
More and more .NET APIs are cancelable, which is great for writing robust, hang-free code. However, passing an instance of CancellationToken
down through the call stack to reach all of these cancelable method calls is rather clunky. CancellationProvider
solves this by using dependency injection to flow the token, thereby allowing services that call cancelable APIs to consume it without other services being aware:
// in Program.cs (ASP.NET Core app)
builder.Services.AddScoped(p => new CancellationProvider(p.GetRequiredService<IHttpContextAccessor>().HttpContext?.RequestAborted));
// OR in Program.cs (Console app)
using CancellationTokenSource source = new();
Console.CancelKeyPress += (o, e) =>
{
source.Cancel();
e.Cancel = true; // Prevent the process from terminating immediately
};
services.AddSingleton(new CancellationProvider(source.Token));
// in MyService.cs
class MyService(CancellationProvider cancellationProvider)
{
public async Task DoSomethingAsync()
{
...
await command.ExecuteNonQueryAsync(cancellationProvider.Token); // use the token for cancelable operations
...
}
}
Scopes
Sometimes, you might still want more fine-grained control over cancellation, for example setting a timeout for a particular operation or eschewing cancellation during a critical step. CancellationProvider
offers a scoping mechanism to customize the provider's behavior in logical regions of code:
class MyService(CancellationProvider cancellationProvider, OtherService otherService)
{
public async Task DoStuff()
{
// run some code with a strict timeout. Assumes OtherService and/or its dependencies are leveraging CancellationProvider
using CancellationTokenSource timeoutSource = new(TimeSpan.FromSeconds(5));
using (cancellationProvider.BeginScope(timeoutSource.Token))
{
await otherService.DoSomethingAsync();
}
// avoid canceling a critical operation. Assumes OtherService and/or its dependencies are leveraging CancellationProvider
using (cancellationProvider.BeginCleanScope())
{
await otherService.DoSomethingAsync();
}
}
}
Scopes are also useful when you have singleton services that want to use the cancellation provider in a web application. For example in an ASP.NET Core app you could do this:
// register a singleton CancellationProvider linked to the host lifetime
builder.Services.AddSingleton(p => new CancellationProvider(p.GetRequiredService<IHostApplicationLifetime>().ApplicationStopping));
app.Use(async (context, next) =>
{
// on each request, enter a scope tied to the request's cancellation token
using var scope = context.RequestServices.GetRequiredService<CancellationProvider>().BeginScope(context.RequestAborted);
await next();
});
Release notes
- 1.0.0
- Initial release
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. 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. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- No dependencies.
-
net8.0
- No dependencies.
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 | 1,143 | 6/29/2024 |