AsyncSemaphore 1.2.2
dotnet add package AsyncSemaphore --version 1.2.2
NuGet\Install-Package AsyncSemaphore -Version 1.2.2
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="AsyncSemaphore" Version="1.2.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add AsyncSemaphore --version 1.2.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: AsyncSemaphore, 1.2.2"
#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.
// Install AsyncSemaphore as a Cake Addin #addin nuget:?package=AsyncSemaphore&version=1.2.2 // Install AsyncSemaphore as a Cake Tool #tool nuget:?package=AsyncSemaphore&version=1.2.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
AsyncSemaphore
A simple wrapper around a SemaphoreSlim
that supports automatic releasing of a lock on scope exit with the using
keyword.
No more try/finally
code blocks!
Install
dotnet add package AsyncSemaphore
Usage
private readonly AsyncSemaphore _asyncSemaphore = new AsyncSemaphore(1);
public async Task MyMethod()
{
// Just assign the `IDisposable` returned from `WaitAsync` to a variable and use the using statement with it
using var lockHandle = await _asyncSemaphore.WaitAsync();
// Do whatever you want - Even if we throw exceptions, we'll release the semaphore once we leave this method's scope
await DoSomethingInsideLock();
}
or scoped:
private readonly AsyncSemaphore _asyncSemaphore = new AsyncSemaphore(1);
public async Task MyMethod()
{
// or create your own scope with {} braces - And after you leave that scope, your lock will be released
using (await _asyncSemaphore.WaitAsync())
{
await DoSomethingInsideLock();
}
await DoSomethingAfterLockReleased();
}
Benchmarks and allocations can be seen below.
BenchmarkDotNet v0.13.12, Windows 11 (10.0.22621.3593/22H2/2022Update/SunValley2)
11th Gen Intel Core i7-1185G7 3.00GHz, 1 CPU, 8 logical and 4 physical cores
.NET SDK 8.0.106
[Host] : .NET 8.0.6 (8.0.624.26715), X64 RyuJIT AVX-512F+CD+BW+DQ+VL+VBMI
DefaultJob : .NET 8.0.6 (8.0.624.26715), X64 RyuJIT AVX-512F+CD+BW+DQ+VL+VBMI
Method | Mean | Error | StdDev | Allocated |
---|---|---|---|---|
Raw_Semaphore_Slim | 39.65 ns | 0.777 ns | 1.402 ns | - |
AsyncSemaphore_With_Inherited_Scope | 46.23 ns | 0.464 ns | 0.411 ns | - |
AsyncSemaphore_With_Braced_Scope | 44.91 ns | 0.500 ns | 0.444 ns | - |
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. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.0
- AsyncSemaphore.Analyzers (>= 1.2.2)
- System.Threading.Tasks.Extensions (>= 4.5.4)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on AsyncSemaphore:
Package | Downloads |
---|---|
ModularPipelines
Write your pipelines in C#! |
|
DotnetModularPipelines
Write your pipelines in C#! |
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on AsyncSemaphore:
Repository | Stars |
---|---|
thomhurst/ModularPipelines
Write your pipelines in C# !
|