Metalama.Community.AutoCancellationToken
2024.1.12
Prefix Reserved
See the version list below for details.
dotnet add package Metalama.Community.AutoCancellationToken --version 2024.1.12
NuGet\Install-Package Metalama.Community.AutoCancellationToken -Version 2024.1.12
<PackageReference Include="Metalama.Community.AutoCancellationToken" Version="2024.1.12" />
paket add Metalama.Community.AutoCancellationToken --version 2024.1.12
#r "nuget: Metalama.Community.AutoCancellationToken, 2024.1.12"
// Install Metalama.Community.AutoCancellationToken as a Cake Addin
#addin nuget:?package=Metalama.Community.AutoCancellationToken&version=2024.1.12
// Install Metalama.Community.AutoCancellationToken as a Cake Tool
#tool nuget:?package=Metalama.Community.AutoCancellationToken&version=2024.1.12
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.
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:
- A
CancellationToken
parameter is added to allasync
methods that don't have it. - A
CancelltionToken
argument is added to calls withinasync
methods where:CancellationToken
can be added as a last argument and the added argument corresponds to aCancellationToken
parameter (e.g. it's not aparams object[]
parameter or a generic parameter). The added argument can result in calling a different overload of the method, or specifying a value for an optional parameter.- The call is not in a
static
local function. - The containing method doesn't have two or more
CancellationToken
parameters, since it wouldn't be clear which one to use.
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 was computed. 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
- Metalama.Framework (>= 2024.1.12)
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 |
---|---|---|
2024.2.9-preview | 49 | 6/11/2024 |
2024.2.8-preview | 48 | 6/6/2024 |
2024.2.7-preview | 69 | 5/30/2024 |
2024.2.6-preview | 65 | 5/25/2024 |
2024.2.5-preview | 76 | 5/6/2024 |
2024.2.4-preview | 82 | 5/4/2024 |
2024.2.3-preview | 72 | 4/30/2024 |
2024.2.2-preview | 73 | 4/23/2024 |
2024.2.1-preview | 62 | 4/11/2024 |
2024.1.22 | 60 | 6/15/2024 |
2024.1.21 | 67 | 6/6/2024 |
2024.1.20 | 72 | 5/30/2024 |
2024.1.19 | 71 | 5/24/2024 |
2024.1.18 | 107 | 5/6/2024 |
2024.1.17 | 45 | 5/3/2024 |
2024.1.16 | 85 | 4/30/2024 |
2024.1.15 | 77 | 4/29/2024 |
2024.1.14 | 74 | 4/23/2024 |
2024.1.13 | 75 | 4/23/2024 |
2024.1.12 | 89 | 4/17/2024 |
2024.1.11-rc | 65 | 4/11/2024 |
2024.1.10-rc | 87 | 4/4/2024 |
2024.1.9-rc | 69 | 3/27/2024 |
2024.1.8-preview | 65 | 3/25/2024 |
2024.1.7-preview | 76 | 3/19/2024 |
2024.1.6-preview | 74 | 3/6/2024 |
2024.1.5-preview | 69 | 2/29/2024 |
2024.1.4-preview | 76 | 2/27/2024 |
2024.1.3-preview | 75 | 2/23/2024 |
2024.1.2-preview | 79 | 2/7/2024 |
2024.1.1-preview | 64 | 1/30/2024 |
2024.0.16 | 57 | 6/15/2024 |
2024.0.15 | 76 | 6/6/2024 |
2024.0.14 | 65 | 5/30/2024 |
2024.0.13 | 69 | 5/24/2024 |
2024.0.12 | 87 | 4/17/2024 |
2024.0.11 | 99 | 3/21/2024 |
2024.0.10 | 77 | 3/19/2024 |
2024.0.9 | 113 | 2/29/2024 |
2024.0.8 | 130 | 2/23/2024 |
2024.0.7 | 104 | 2/7/2024 |
2024.0.6 | 178 | 1/3/2024 |
2024.0.5-rc | 99 | 12/21/2023 |
2024.0.4-rc | 121 | 12/12/2023 |
2024.0.3-preview | 117 | 12/6/2023 |
2024.0.2-preview | 118 | 11/14/2023 |
2024.0.1-preview | 95 | 11/6/2023 |
2023.4.9 | 79 | 2/7/2024 |
2023.4.8 | 109 | 12/21/2023 |
2023.4.7 | 132 | 12/12/2023 |
2023.4.6 | 148 | 11/7/2023 |
2023.4.5-rc | 110 | 10/26/2023 |
2023.4.4-preview | 110 | 10/18/2023 |
2023.4.3-preview | 102 | 10/4/2023 |
2023.4.2-preview | 107 | 9/26/2023 |
2023.4.1-preview | 102 | 9/13/2023 |
2023.3.10 | 93 | 12/21/2023 |
2023.3.9 | 115 | 12/12/2023 |
2023.3.8 | 136 | 10/17/2023 |
2023.3.7-rc | 113 | 9/29/2023 |
2023.3.6-rc | 117 | 9/26/2023 |
2023.3.5-rc | 117 | 9/13/2023 |
2023.3.4-preview | 127 | 8/30/2023 |
2023.3.3-preview | 130 | 8/29/2023 |
2023.3.2-preview | 332 | 8/1/2023 |
2023.3.1-preview | 243 | 7/28/2023 |
2023.2.5 | 324 | 9/12/2023 |
2023.2.4 | 300 | 8/7/2023 |
2023.2.3-rc | 269 | 8/3/2023 |
2023.2.2-rc | 276 | 7/21/2023 |
2023.2.1-preview | 307 | 6/27/2023 |
2023.1.7 | 289 | 9/12/2023 |
2023.1.6 | 320 | 8/7/2023 |
2023.1.5 | 167 | 7/17/2023 |
2023.1.4 | 184 | 6/27/2023 |