444

The await keyword in C# (.NET Async CTP) is not allowed from within a lock statement.

From MSDN:

An await expression cannot be used in a synchronous function, in a query expression, in the catch or finally block of an exception handling statement, in the block of a lock statement, or in an unsafe context.

I assume this is either difficult or impossible for the compiler team to implement for some reason.

I attempted a work around with the using statement:

class Async
{
    public static async Task<IDisposable> Lock(object obj)
    {
        while (!Monitor.TryEnter(obj))
            await TaskEx.Yield();

        return new ExitDisposable(obj);
    }

    private class ExitDisposable : IDisposable
    {
        private readonly object obj;
        public ExitDisposable(object obj) { this.obj = obj; }
        public void Dispose() { Monitor.Exit(this.obj); }
    }
}

// example usage
using (await Async.Lock(padlock))
{
    await SomethingAsync();
}

However this does not work as expected. The call to Monitor.Exit within ExitDisposable.Dispose seems to block indefinitely (most of the time) causing deadlocks as other threads attempt to acquire the lock. I suspect the unreliability of my work around and the reason await statements are not allowed in lock statement are somehow related.

Does anyone know why await isn't allowed within the body of a lock statement?

Kevin
  • 7,734
  • 4
  • 26
  • 31
  • 37
    I'd imagine you found the reason why it's not allowed. – asawyer Sep 30 '11 at 15:29
  • 3
    May I suggest this link: http://www.hanselman.com/blog/ComparingTwoTechniquesInNETAsynchronousCoordinationPrimitives.aspx and this one : http://blogs.msdn.com/b/pfxteam/archive/2012/02/12/10266988.aspx – hans Dec 25 '12 at 20:27
  • I'm just starting to catch up and learn a little more about async programming. After numerous deadlocks in my wpf applications, I found this article to be a great safe guard in async programming practices. https://msdn.microsoft.com/en-us/magazine/jj991977.aspx?f=255&MSPPError=-2147217396 – C. Tewalt Mar 28 '16 at 17:01
  • 2
    Lock is designed to prevent async access when async access would break your code, ergo if you are using async inside a lock your have invalidated your lock.. so if you need to await something inside your lock you are not using the lock correctly – MikeT Jan 08 '18 at 14:01
  • blogs.msdn.com/b/pfxteam/archive/2012/02/12/10266988.aspx is dead, I believe it is https://devblogs.microsoft.com/pfxteam/building-async-coordination-primitives-part-6-asynclock/ and https://devblogs.microsoft.com/pfxteam/building-async-coordination-primitives-part-7-asyncreaderwriterlock/ now – prime23 Dec 21 '21 at 06:39
  • Here you can find a possible solution for you: https://blog.cdemi.io/async-waiting-inside-c-sharp-locks/ – peter70 May 11 '22 at 10:04

8 Answers8

454

I assume this is either difficult or impossible for the compiler team to implement for some reason.

No, it is not at all difficult or impossible to implement -- the fact that you implemented it yourself is a testament to that fact. Rather, it is an incredibly bad idea and so we don't allow it, so as to protect you from making this mistake.

call to Monitor.Exit within ExitDisposable.Dispose seems to block indefinitely (most of the time) causing deadlocks as other threads attempt to acquire the lock. I suspect the unreliability of my work around and the reason await statements are not allowed in lock statement are somehow related.

Correct, you have discovered why we made it illegal. Awaiting inside a lock is a recipe for producing deadlocks.

I'm sure you can see why: arbitrary code runs between the time the await returns control to the caller and the method resumes. That arbitrary code could be taking out locks that produce lock ordering inversions, and therefore deadlocks.

Worse, the code could resume on another thread (in advanced scenarios; normally you pick up again on the thread that did the await, but not necessarily) in which case the unlock would be unlocking a lock on a different thread than the thread that took out the lock. Is that a good idea? No.

I note that it is also a "worst practice" to do a yield return inside a lock, for the same reason. It is legal to do so, but I wish we had made it illegal. We're not going to make the same mistake for "await".

Eric Lippert
  • 630,995
  • 172
  • 1,214
  • 2,051
  • 253
    How do you handle a scenario where you need to return a cache entry, and if the entry does not exist you need to compute asynchronously the content then add+return the entry, making sure nobody else calls you in the meantime ? – Softlion Aug 25 '12 at 05:32
  • 12
    I realise I'm late to the party here, however I was surprised to see that you put deadlocks as the primary reason why this is a bad idea. I had come to the conclusion in my own thinking that the re-entrant nature of lock/Monitor would be a bigger part of the problem. That is, you queue two tasks to the thread pool which lock(), that in a synchronous world would execute on separate threads. But now with await (if allowed I mean) you could have two tasks executing within the lock block because the thread was reused. Hilarity ensues. Or did I misunderstand something? – Gareth Wilson Dec 12 '12 at 22:56
  • 4
    @GarethWilson: I talked about deadlocks *because the question asked was about deadlocks*. You are correct that bizarre re-entrancy issues are possible and seem likely. – Eric Lippert Dec 12 '12 at 23:10
  • 1
    @EricLippert why a full set of coordination pimitives weren't added as well to .NET framework? There seems to exist AsyncSemaphore, AsyncManualResetEvent, but they are part of Microsoft.VisualStudio.Threading namespace. Also AsyncLock and and AsynAutoResetEvent are covered by Stephen Toub blog. Not having them in the core framework gives me the feeling I'm still missing something important in understanding async/await pattern. – ceztko Mar 12 '14 at 21:30
  • 14
    @Eric Lippert. Given that the `SemaphoreSlim.WaitAsync` class was added to the .NET framework well after you posted this answer, I think we can safely assume that it is possible now. Regardless of this, your comments about the difficulty of implementing such a construct are still entirely valid. – Contango Sep 12 '14 at 08:34
  • 13
    "arbitrary code runs between the time the await returns control to the caller and the method resumes" - surely this is true of any code, even in the absence of async/await, in a multithreaded context: other threads may execute arbitrary code at any time, and said arbitrary code as you say "could be taking out locks that produce lock ordering inversions, and therefore deadlocks." So why is this of particular significance with async/await? I understand the second point re "the code could resume on another thread" of being of particular significance to async/await. – bacar Sep 28 '16 at 22:12
  • 2
    @Contango `SemaphoreSlim` still allows you to do a lock inversion (ouch), but at least it doesn't have thread-affinity and reëntrancy. That at least means you don't care on what thread you do the "blocking". – Luaan Oct 10 '16 at 10:59
  • 1
    As @Contango mentioned, here is a good implementation i found: https://blog.cdemi.io/async-waiting-inside-c-sharp-locks – Rzassar Jan 29 '19 at 17:59
  • How do you solve write/delete/read data race with the same file with uwp api? In uwp I only have async file api, So I have to lock those file operation with aysnc api. So it is not a bad idea, it is the only way to solve this problem. – bronze man Jun 27 '19 at 13:04
  • Related: [What is a “lock ordering inversion”?](https://softwareengineering.stackexchange.com/questions/425016/what-is-a-lock-ordering-inversion) – OfirD Jun 17 '21 at 22:05
383

Use SemaphoreSlim.WaitAsync method.

 await mySemaphoreSlim.WaitAsync();
 try {
     await Stuff();
 } finally {
     mySemaphoreSlim.Release();
 }
Legends
  • 19,109
  • 11
  • 87
  • 115
user1639030
  • 3,870
  • 1
  • 11
  • 5
  • 17
    As this method was introduced into the .NET framework recently, I think we can assume that the concept of locking in an async/await world is now well proven. – Contango Sep 12 '14 at 08:41
  • Upvoted, but is awaiting within the `try` this such a good idea? From my understanding, if `Stuff` is something long running like making an HTTP request, it could hold the semaphore for seconds. In the meantime, other tasks calling `WaitAsync` would be unable to continue. While this might not cause responsiveness issues because they yield immediately to the caller, there would be a bunch of tasks just doing nothing for a long time. – James Ko Nov 04 '16 at 22:40
  • 8
    For some more info, search for the text "SemaphoreSlim" in this article: [Async/Await - Best Practices in Asynchronous Programming](https://msdn.microsoft.com/en-us/magazine/jj991977.aspx) – BobbyA Jun 23 '17 at 20:28
  • 2
    @JamesKo if all those tasks are waiting for the result of `Stuff` I don't see any way around it... – Ohad Schneider Jun 29 '17 at 15:50
  • @Contango no a semaphore and a lock are not the same thing, A lock uses a semaphore internally to operated the lock which has lead to people misusing them as a semaphore, but a lock should NEVER contain async code – MikeT Jan 08 '18 at 14:11
  • 17
    Shouldn't it be initialized as `mySemaphoreSlim = new SemaphoreSlim(1, 1)` in order to work like `lock(...)`? – Sergei May 02 '18 at 16:14
  • 4
    Added the extended version of this answer: https://stackoverflow.com/a/50139704/1844247 – Sergei May 02 '18 at 16:53
  • 2
    @JamesKo that's the whole point of using a semaphore as a mutex. Only one task should execute Stuff, therefore all other tasks have to wait for the previous task to release lock and take their turn into acquiring it one by one. It's like a bunch of people waiting outside the toilet to use it (having one toilet only). When they say to their friends "i'm going to the toilet" it doesn't mean they go and come back instantly. It means they go, wait for all others to finish, then use the toilet and come back. – Thanasis Ioannidis Jun 22 '18 at 11:35
  • 1
    Awaiting semaphore outside `try` block can be dangerous, see the following thread: https://stackoverflow.com/a/61806749/7889645 – AndreyCh May 14 '20 at 20:30
77

Basically it would be the wrong thing to do.

There are two ways this could be implemented:

  • Keep hold of the lock, only releasing it at the end of the block.
    This is a really bad idea as you don't know how long the asynchronous operation is going to take. You should only hold locks for minimal amounts of time. It's also potentially impossible, as a thread owns a lock, not a method - and you may not even execute the rest of the asynchronous method on the same thread (depending on the task scheduler).

  • Release the lock in the await, and reacquire it when the await returns
    This violates the principle of least astonishment IMO, where the asynchronous method should behave as closely as possible like the equivalent synchronous code - unless you use Monitor.Wait in a lock block, you expect to own the lock for the duration of the block.

So basically there are two competing requirements here - you shouldn't be trying to do the first here, and if you want to take the second approach you can make the code much clearer by having two separated lock blocks separated by the await expression:

// Now it's clear where the locks will be acquired and released
lock (foo)
{
}
var result = await something;
lock (foo)
{
}

So by prohibiting you from awaiting in the lock block itself, the language is forcing you to think about what you really want to do, and making that choice clearer in the code that you write.

Jon Skeet
  • 1,335,956
  • 823
  • 8,931
  • 9,049
  • 5
    Given that the `SemaphoreSlim.WaitAsync` class was added to the .NET framework well after you posted this answer, I think we can safely assume that it is possible now. Regardless of this, your comments about the difficulty of implementing such a construct are still entirely valid. – Contango Sep 12 '14 at 08:37
  • 7
    @Contango: Well that's not *quite* the same thing. In particular, the semaphore isn't tied to a specific thread. It achieves similar goals to lock, but there are significant differences. – Jon Skeet Sep 12 '14 at 12:43
  • @JonSkeet i know this is a veryyy old thread and all, but i am not sure how the something() call is protected using those locks in the second way ? when a thread is executing something() any other thread can get involve in it as well ! Am i missing something here ? –  Jul 11 '19 at 09:10
  • @Joseph: It's not protected at that point. It's the second approach, which makes it clear that you're acquiring/releasing, then acquiring/releasing again, possibly on a different thread. Because the first approach is a bad idea, as per Eric's answer. – Jon Skeet Jul 11 '19 at 09:17
68

This is just an extension to this answer.

using System;
using System.Threading;
using System.Threading.Tasks;

public class SemaphoreLocker
{
    private readonly SemaphoreSlim _semaphore = new SemaphoreSlim(1, 1);

    public async Task LockAsync(Func<Task> worker)
    {
        await _semaphore.WaitAsync();
        try
        {
            await worker();
        }
        finally
        {
            _semaphore.Release();
        }
    }

    // overloading variant for non-void methods with return type (generic T)
    public async Task<T> LockAsync<T>(Func<Task<T>> worker)
    {
        await _semaphore.WaitAsync();
        try
        {
            return await worker();
        }
        finally
        {
            _semaphore.Release();
        }
    }
}

Usage:

public class Test
{
    private static readonly SemaphoreLocker _locker = new SemaphoreLocker();

    public async Task DoTest()
    {
        await _locker.LockAsync(async () =>
        {
            // [async] calls can be used within this block 
            // to handle a resource by one thread. 
        });
        // OR
        var result = await _locker.LockAsync(async () =>
        {
            // [async] calls can be used within this block 
            // to handle a resource by one thread. 
        });
    }
}
Jesse C. Slicer
  • 19,457
  • 3
  • 66
  • 82
Sergei
  • 5,507
  • 4
  • 34
  • 50
  • 3
    It can be dangerous to get the semaphore lock outside the `try` block - if an exception happens between `WaitAsync` and `try` the semaphore will be never released (deadlock). On the other hand, moving `WaitAsync` call into the `try` block will introduce another issue, when the semaphore can be released without a lock being acquired. See the related thread where this problem was explained: https://stackoverflow.com/a/61806749/7889645 – AndreyCh May 14 '20 at 20:24
  • I can't believe this actually helped me. Huge thanks to this answer. The only thing I should add is that you should add a generic type so if someone needs to "get a value from an async method" he will be able to use this. `Task LockAsync(Func> worker)` ... and then you assign the return value as T result = default; then in the try you write result = await worker(); and after the finally block you return result; It's simple, but not everyone knows how to deal with generics, Func,Task types, etc.Still great answer though. If you have time, add the return functionality. Thanks again – Nikolai Jun 29 '20 at 13:16
  • @Nikolai Do you mean to add a second generic method in addition to the current one? – Sergei Jun 29 '20 at 13:59
  • @Sergey Yes. It's hard to explain in a comment. I will show you what I needed: `Skill = await locker.LockAsync(async () => { return await skillRepository.GetByIdAsync(skill.Id); });` And I basically needed to add a generic type so the LockAsync to return the result from the async method. As I said I knew how to "tweak" your method and it worked like a charm. Many people will need something similar and it would be nice to have both of the solutions - for Task void calls and Task with returned value of type T. – Nikolai Jun 29 '20 at 14:46
  • @Nikolai Sounds reasonable, but I haven't used Semaphore for a while and therefore I'm a bit out of this context. If you're sure, you're welcome to edit my answer and add your function, if you'd like to. – Sergei Jun 29 '20 at 16:10
  • @Sergey Done. Check the edit. It's not that related to semaphore. It's related to retrieving the type from the function we're locking, because you're solution is great, but only works if the function we're locking is void and I just added an overloaded version where we can get also the returned value. It's pretty simple, but nice addition I think. – Nikolai Jun 30 '20 at 09:30
  • 1
    @Nikolai thank you for participating! You're right, but I haven't been using `async`/`await` as well for more than a year since I've shifted my technology stack a bit. By the way, what do you think of AndreyCh's comment? I really didn't have time to go into his remark and say anything about it. – Sergei Jun 30 '20 at 16:48
  • @Sergey It's probably really reasonable, but I'm not an expert with Semaphore and I can't make the proper tests to enforce deadlock scenarios. I will try his solution tomorrow, but for now I used your solution and it worked like a charm. I'm using your solution for the last 2 days and I haven't had any deadlock issues yet. – Nikolai Jun 30 '20 at 23:55
18

This referes to Building Async Coordination Primitives, Part 6: AsyncLock , http://winrtstoragehelper.codeplex.com/ , Windows 8 app store and .net 4.5

Here is my angle on this:

The async/await language feature makes many things fairly easy but it also introduces a scenario that was rarely encounter before it was so easy to use async calls: reentrance.

This is especially true for event handlers, because for many events you don't have any clue about whats happening after you return from the event handler. One thing that might actually happen is, that the async method you are awaiting in the first event handler, gets called from another event handler still on the same thread.

Here is a real scenario I came across in a windows 8 App store app: My app has two frames: coming into and leaving from a frame I want to load/safe some data to file/storage. OnNavigatedTo/From events are used for the saving and loading. The saving and loading is done by some async utility function (like http://winrtstoragehelper.codeplex.com/). When navigating from frame 1 to frame 2 or in the other direction, the async load and safe operations are called and awaited. The event handlers become async returning void => they cant be awaited.

However, the first file open operation (lets says: inside a save function) of the utility is async too and so the first await returns control to the framework, which sometime later calls the other utility (load) via the second event handler. The load now tries to open the same file and if the file is open by now for the save operation, fails with an ACCESSDENIED exception.

A minimum solution for me is to secure the file access via a using and an AsyncLock.

private static readonly AsyncLock m_lock = new AsyncLock();
...

using (await m_lock.LockAsync())
{
    file = await folder.GetFileAsync(fileName);
    IRandomAccessStream readStream = await file.OpenAsync(FileAccessMode.Read);
    using (Stream inStream = Task.Run(() => readStream.AsStreamForRead()).Result)
    {
        return (T)serializer.Deserialize(inStream);
    }
}

Please note that his lock basically locks down all file operation for the utility with just one lock, which is unnecessarily strong but works fine for my scenario.

Here is my test project: a windows 8 app store app with some test calls for the original version from http://winrtstoragehelper.codeplex.com/ and my modified version that uses the AsyncLock from Stephen Toub.

May I also suggest this link: http://www.hanselman.com/blog/ComparingTwoTechniquesInNETAsynchronousCoordinationPrimitives.aspx

prime23
  • 3,282
  • 2
  • 34
  • 50
hans
  • 981
  • 1
  • 10
  • 14
9

Stephen Taub has implemented a solution to this question, see Building Async Coordination Primitives, Part 7: AsyncReaderWriterLock.

Stephen Taub is highly regarded in the industry, so anything he writes is likely to be solid.

I won't reproduce the code that he posted on his blog, but I will show you how to use it:

/// <summary>
///     Demo class for reader/writer lock that supports async/await.
///     For source, see Stephen Taub's brilliant article, "Building Async Coordination
///     Primitives, Part 7: AsyncReaderWriterLock".
/// </summary>
public class AsyncReaderWriterLockDemo
{
    private readonly IAsyncReaderWriterLock _lock = new AsyncReaderWriterLock(); 

    public async void DemoCode()
    {           
        using(var releaser = await _lock.ReaderLockAsync()) 
        { 
            // Insert reads here.
            // Multiple readers can access the lock simultaneously.
        }

        using (var releaser = await _lock.WriterLockAsync())
        {
            // Insert writes here.
            // If a writer is in progress, then readers are blocked.
        }
    }
}

If you want a method that's baked into the .NET framework, use SemaphoreSlim.WaitAsync instead. You won't get a reader/writer lock, but you will get tried and tested implementation.

Pang
  • 9,073
  • 146
  • 84
  • 117
Contango
  • 71,009
  • 55
  • 247
  • 290
  • I'm curious to know if there are any caveats to using this code. If anyone can demonstrate any issues with this code, I'd like to know. However, what is true is that the concept of async/await locking is definitely well proven, as `SemaphoreSlim.WaitAsync` is in the .NET framework. All this code does is add a reader/writer lock concept. – Contango Sep 12 '14 at 08:40
2

Hmm, looks ugly, seems to work.

static class Async
{
    public static Task<IDisposable> Lock(object obj)
    {
        return TaskEx.Run(() =>
            {
                var resetEvent = ResetEventFor(obj);

                resetEvent.WaitOne();
                resetEvent.Reset();

                return new ExitDisposable(obj) as IDisposable;
            });
    }

    private static readonly IDictionary<object, WeakReference> ResetEventMap =
        new Dictionary<object, WeakReference>();

    private static ManualResetEvent ResetEventFor(object @lock)
    {
        if (!ResetEventMap.ContainsKey(@lock) ||
            !ResetEventMap[@lock].IsAlive)
        {
            ResetEventMap[@lock] =
                new WeakReference(new ManualResetEvent(true));
        }

        return ResetEventMap[@lock].Target as ManualResetEvent;
    }

    private static void CleanUp()
    {
        ResetEventMap.Where(kv => !kv.Value.IsAlive)
                     .ToList()
                     .ForEach(kv => ResetEventMap.Remove(kv));
    }

    private class ExitDisposable : IDisposable
    {
        private readonly object _lock;

        public ExitDisposable(object @lock)
        {
            _lock = @lock;
        }

        public void Dispose()
        {
            ResetEventFor(_lock).Set();
        }

        ~ExitDisposable()
        {
            CleanUp();
        }
    }
}
Anton Pogonets
  • 1,134
  • 7
  • 16
-1

I did try using a Monitor (code below) which appears to work but has a GOTCHA... when you have multiple threads it will give... System.Threading.SynchronizationLockException Object synchronization method was called from an unsynchronized block of code.

using System;
using System.Threading;
using System.Threading.Tasks;

namespace MyNamespace
{
    public class ThreadsafeFooModifier : 
    {
        private readonly object _lockObject;

        public async Task<FooResponse> ModifyFooAsync()
        {
            FooResponse result;
            Monitor.Enter(_lockObject);
            try
            {
                result = await SomeFunctionToModifyFooAsync();
            }
            finally
            {
                Monitor.Exit(_lockObject);
            }
            return result;
        }
    }
}

Prior to this I was simply doing this, but it was in an ASP.NET controller so it resulted in a deadlock.

public async Task<FooResponse> ModifyFooAsync() { lock(lockObject) { return SomeFunctionToModifyFooAsync.Result; } }

andrew pate
  • 3,301
  • 32
  • 19