Skip to main content

Using the AsyncController in ASP.NET MVC 2

On the Web server, the .NET Framework maintains a pool of threads that are used to service ASP.NET requests. When a request arrives, a thread from the pool is dispatched to process that request. If the request is processed synchronously, the thread that processes the request is blocked while the request is being processed, and that thread cannot service another request.

If you have multiple long-running requests, all available threads might be blocked and the Web server rejects any additional request with an HTTP 503 status (Server Too Busy).

To solve this issue in ASP.NET MVC, actions can be processed asynchronously by deriving your controllers from the AsyncController class.

For example, let’s convert this code sample into a more efficient asynchronous alternative:

   1:  public class HomeController: Controller 
   2:  {
   3:      public ActionResult LongRunningAction() 
   4:      {
   5:          DoLengthyOperation();
   6:          return View();
   7:      }
   8:   
   9:      private void DoLengthyOperation()
  10:      {
  11:          Thread.Sleep(5000);
  12:      }
  13:   
  14:  }

To convert this synchronous action method to an asynchronous action method involves the following steps:


  1. Instead of deriving the controller from Controller, derive it from AsyncController. Controllers that derive from AsyncController enable ASP.NET to process asynchronous requests, and they can still service synchronous action methods.


  2. Create two methods for the action. The method that initiates the asynchronous process must have a name that consists of the action and the suffix "Async". The method that is invoked when the asynchronous process finishes (the callback method) must have a name that consists of the action and the suffix "Completed". In the previous example, the LongRunningAction method has been turned into two methods: LongRunningActionAsync and LongRunningActionCompleted.

    The LongRunningActionAsync method returns void. The LongRunningActionCompleted method returns an ActionResult instance. Although the action consists of two methods, it is accessed using the same URL as for a synchronous action method (for example, Home/LongRunningAction). Methods such as RedirectToAction and RenderAction will also refer to the action method as LongRunningAction and not LongRunningActionAsync.

    The parameters that are passed to LongRunningActionAsync use the normal parameter binding mechanisms. The parameters that are passed to LongRunningActionCompleted use the Parameters dictionary.


  3. Replace the synchronous call in the original ActionResult method with an asynchronous call in the asynchronous action method.

   1:  public class HomeController : AsyncController 
   2:  {
   3:      public void LongRunningActionAsync() 
   4:      {
   5:          AsyncManager.OutstandingOperations.Increment();
   6:          Task.Factory.StartNew(() => DoLengthyOperation());
   7:      }
   8:   
   9:      private void DoLengthyOperation()
  10:      {
  11:          Thread.Sleep(5000);
  12:          AsyncManager.Parameters["message"] = "hello world";
  13:          AsyncManager.OutstandingOperations.Decrement();
  14:      }
  15:   
  16:   
  17:      public ActionResult LongRunningActionCompleted(string message) 
  18:      {
  19:          return View();
  20:      }
  21:  }

More information here.

Popular posts from this blog

DevToys–A swiss army knife for developers

As a developer there are a lot of small tasks you need to do as part of your coding, debugging and testing activities.  DevToys is an offline windows app that tries to help you with these tasks. Instead of using different websites you get a fully offline experience offering help for a large list of tasks. Many tools are available. Here is the current list: Converters JSON <> YAML Timestamp Number Base Cron Parser Encoders / Decoders HTML URL Base64 Text & Image GZip JWT Decoder Formatters JSON SQL XML Generators Hash (MD5, SHA1, SHA256, SHA512) UUID 1 and 4 Lorem Ipsum Checksum Text Escape / Unescape Inspector & Case Converter Regex Tester Text Comparer XML Validator Markdown Preview Graphic Color B

Help! I accidently enabled HSTS–on localhost

I ran into an issue after accidently enabling HSTS for a website on localhost. This was not an issue for the original website that was running in IIS and had a certificate configured. But when I tried to run an Angular app a little bit later on http://localhost:4200 the browser redirected me immediately to https://localhost . Whoops! That was not what I wanted in this case. To fix it, you need to go the network settings of your browser, there are available at: chrome://net-internals/#hsts edge://net-internals/#hsts brave://net-internals/#hsts Enter ‘localhost’ in the domain textbox under the Delete domain security policies section and hit Delete . That should do the trick…

Azure DevOps/ GitHub emoji

I’m really bad at remembering emoji’s. So here is cheat sheet with all emoji’s that can be used in tools that support the github emoji markdown markup: All credits go to rcaviers who created this list.