PostSharp/Metalama.Community.AutoCancellationTokenv2026.1.2-preview

Metalama.Community.AutoCancellationToken

Automatically propagates CancellationToken parameter to async methods and method calls within them.

This is a Metalama aspect. It modifies your code during compilation by using source weaving.

<!-- You can also [try this aspect on try.metalama.net](https://try.metalama.net/#autocancellationtoken). --> <!-- [](https://github.com/postsharp/Metalama.Community.AutoCancellationToken/actions?query=workflow%3A%22Full+Pipeline%22) -->

Example

Your code:

[AutoCancellationToken] class C { async Task MakeRequests(CancellationToken ct) { using var client = new HttpClient(); await MakeRequest(client); } private static async Task MakeRequest(HttpClient client) => await client.GetAsync("https://example.org"); }

What gets compiled:

class C { async Task MakeRequests(CancellationToken ct) { using var client = new HttpClient(); await MakeRequest(client, ct); } private static async Task MakeRequest(HttpClient client, CancellationToken cancellationToken = default) => await client.GetAsync("https://example.org", cancellationToken); }

Notice that CancellationToken parameter was added to the declaration of MakeRequest and that CancellationToken argument was added to the calls of MakeRequest and HttpClient.GetAsync.

Installation

Install the NuGet package: dotnet add package Metalama.Community.AutoCancellationToken.

How to use

Add [AutoCancellationToken] to the types where you want it to apply.

By annotating a type with [AutoCancellationToken], you add cancellation to all its async methods. Specifically: