MarkCiliaVincenti/AsyncKeyedLockv3.2.3
.NET 5.0.NET 6.0.NET 7.0.NET 8.0
An asynchronous .NET library that allows you to lock based on a key (keyed semaphores), limiting concurrent threads sharing the same key to a specified number, with optional pooling for reducing memory allocations.
Get Started
$ dotnet add package AsyncKeyedLockReadme
AsyncKeyedLock
An asynchronous .NET Standard 2.0 library that allows you to lock based on a key (keyed semaphores), only allowing a defined number of concurrent threads that share the same key.
For example, if you're processing transactions, you may want to limit to only one transaction per user so that the order is maintained, but meanwhile allowing parallel processing of multiple users.
Benchmarks
Tests show that AsyncKeyedLock is faster than similar libraries, while consuming less memory.
Installation
The recommended means is to use NuGet, but you could also download the source code from here.
Usage
You need to start off with creating an instance of AsyncKeyedLocker or AsyncKeyedLocker<T>. The recommended way is to use the latter, which consumes less memory. The former uses object and may be slightly faster, but at the expense of higher memory usage.
Dependency injection
services.AddSingleton<IAsyncKeyedLocker, AsyncKeyedLocker>();
or:
services.AddSingleton<IAsyncKeyedLocker<string>, AsyncKeyedLocker<string>>();
Variable instantiation
var asyncKeyedLocker = new AsyncKeyedLocker();