Your action may return an IHttpActionResult
which performs the action asynchronously when the framework calls its ExecuteAsync
.
But if you must first make some other async calls before creating and returning the result, then you're forced to change the signature to async Task<IHttpActionResult>
. That's all it is.
If your controller action code doesn't use await
then you can switch back to the simpler signature. However, the result you return will still be asynchronous.
To be clear, in both cases, you are using asynchronous code.
The performance benefit is that - provided all calls to the deepest level are async - a web server thread is not blocked during disk or network I/O, your server can handle more requests with fewer resources.
Think carefully before calling Wait
or Result
on a Task, or creating a Task yourself within ASP.NET code.
Two legitimate reasons to hand-code, intentional multi-threading or parallelism for web server code are:
- when it receives minimal traffic but performs computational work, a call every so often to run a computation over data and you want to use all 16 cores.
- when making >1 simultaneous calls to database shards or >1 other services, you'd make a task for each shard query up front and await them all.
Task<IHttpActionResult>
when you are using theasync
andawait
feature.async
whenever you'd need to implement threading? In the context of Web API methods that perform simple CRUD operations, is there any functional difference between using a method that returnsIHttpActionResult
vsasync Task<IHttpActionResult>
?async
there may be performance improvements at scale, but it is negligible for most web applications. There is no functional difference between sync and async.