I would like to know how to write your own async methods the "correct" way.
I have seen many many posts explaining the async/await pattern like this:
http://msdn.microsoft.com/en-us/library/hh191443.aspx
// Three things to note in the signature: // - The method has an async modifier. // - The return type is Task or Task<T>. (See "Return Types" section.) // Here, it is Task<int> because the return statement returns an integer. // - The method name ends in "Async." async Task<int> AccessTheWebAsync() { // You need to add a reference to System.Net.Http to declare client. HttpClient client = new HttpClient(); // GetStringAsync returns a Task<string>. That means that when you await the // task you'll get a string (urlContents). Task<string> getStringTask = client.GetStringAsync("http://msdn.microsoft.com"); // You can do work here that doesn't rely on the string from GetStringAsync. DoIndependentWork(); // The await operator suspends AccessTheWebAsync. // - AccessTheWebAsync can't continue until getStringTask is complete. // - Meanwhile, control returns to the caller of AccessTheWebAsync. // - Control resumes here when getStringTask is complete. // - The await operator then retrieves the string result from getStringTask. string urlContents = await getStringTask; // The return statement specifies an integer result. // Any methods that are awaiting AccessTheWebAsync retrieve the length value. return urlContents.Length; } private void DoIndependentWork() { resultsTextBox.Text += "Working........\r\n"; }
This works great for any .NET Method that already implements this functionality like
But what if I want to write my own method that takes quite some time to complete where there just is no Method I can use and the heavy load is in the DoIndependentWork
method of the above example?
In this method I could do:
Again I have stumbled across many many posts where people just do the following (again taking the above example):
async Task<int> AccessTheWebAsync() { HttpClient client = new HttpClient(); Task<string> getStringTask = client.GetStringAsync("http://msdn.microsoft.com"); await DoIndependentWork(); string urlContents = await getStringTask; return urlContents.Length; } private Task DoIndependentWork() { return Task.Run(() => { //String manipulations //Calculations //Handling my own objects //Aggregating, comparing, filtering, grouping, handling stuff //List operations, adding, removing, coping }); }
You may notice that the changes are that DoIndependentWork
now returns a Task and in the AccessTheWebAsync
task the method got an await
.
The heavy load operations are now capsulated inside a Task.Run()
, is this all it takes? If that's all it takes is the only thing I need to do to provide async Method for every single method in my library the following:
public class FooMagic { public void DoSomeMagic() { //Do some synchron magic... } public Task DoSomeMagicAsync() { //Do some async magic... ?!? return Task.Run(() => { DoSomeMagic(); }); } }
Would be nice if you could explain it to me since even a high voted question like this: How to write simple async method? only explains it with already existing methods and just using asyn/await pattern like this comment of the mentioned question brings it to the point: How to write simple async method?
The first step is to add the async keyword to the method. It appears in the method signature in the same way that the static keyword does. Then, we need to wait for the download using the await keyword. In terms of C# syntax, await acts as a unary operator, like the !
An async method runs synchronously until it reaches its first await expression, at which point the method is suspended until the awaited task is complete. In the meantime, control returns to the caller of the method, as the example in the next section shows.
The async keyword turns a method into an async method, which allows you to use the await keyword in its body. When the await keyword is applied, it suspends the calling method and yields control back to its caller until the awaited task is complete. await can only be used inside an async method.
You do that using TaskCompletionSource
, which has a Promise Task that doesn't execute any code and only:
"Represents the producer side of a Task unbound to a delegate, providing access to the consumer side through the Task property."
You return that task to the caller when you start the asynchronous operation and you set the result (or exception/cancellation) when you end it. Making sure the operation is really asynchronous is on you.
Here is a good example of this kind of root of all async method in Stephen Toub's AsyncManualResetEvent
implementation:
class AsyncManualResetEvent { private volatile TaskCompletionSource<bool> _tcs = new TaskCompletionSource<bool>(); public Task WaitAsync() { return _tcs.Task; } public void Set() { _tcs.TrySetResult(true); } public void Reset() { while (true) { var tcs = _tcs; if (!tcs.Task.IsCompleted || Interlocked.CompareExchange(ref _tcs, new TaskCompletionSource<bool>(), tcs) == tcs) return; } } }
There are basically two reasons to use async-await
:
I/O
intensive work (or other inherently asynchronous operations), you can call it asynchronously and so you release the calling thread and it's capable of doing other work in the mean time.CPU
intensive work, you can call it asynchronously, which moves the work off of one thread to another (mostly used for GUI
threads).So most of the .Net
framework's asynchronous calls support async
out of the box and for offloading you use Task.Run
(as in your example). The only case where you actually need to implement async
yourself is when you create a new asynchronous call (I/O
or async synchronization constructs for example).
These cases are extremely rare, which is why you mostly find answers that
"Only explains it with already existing methods and just using
async/await
pattern"
You can go deeper in The Nature of TaskCompletionSource
Would be nice if you could explain it to me: How to write simple async method?
First, we need to understand what an async
method means. When one exposes an async
method to the end user consuming the async
method, you're telling him: "Listen, this method will return to you quickly with a promise of completing sometime in the near future". That is what you're guaranteeing to your users.
Now, we need to understand how Task
makes this "promise" possible. As you ask in your question, why simply adding a Task.Run
inside my method makes it valid to be awaited using the await
keyword?
A Task
implements the GetAwaiter
pattern, meaning it returns an object called an awaiter
(Its actually called TaskAwaiter
). The TaskAwaiter
object implements either INotifyCompletion
or ICriticalNotifyCompletion
interfaces, exposing a OnCompleted
method.
All these goodies are in turn used by the compiler once the await
keyword is used. The compiler will make sure that at design time, your object implements GetAwaiter
, and in turn use that to compile the code into a state machine, which will enable your program to yield control back to the caller once awaited, and resume when that work is completed.
Now, there are some guidelines to follow. A true async method doesn't use extra threads behind the scenes to do its job (Stephan Cleary explains this wonderfully in There Is No Thread), meaning that exposing a method which uses Task.Run
inside is a bit misleading to the consumers of your api, because they will assume no extra threading involved in your task. What you should do is expose your API synchronously, and let the user offload it using Task.Run
himself, controlling the flow of execution.
async
methods are primarily used for I/O Bound operations, since these naturally don't need any threads to be consumed while the IO operation is executing, and that is why we see them alot in classes responsible for doing IO operations, such as hard drive calls, network calls, etc.
I suggest reading the Parallel PFX teams article Should I expose asynchronous wrappers for synchronous methods? which talks exactly about what you're trying to do and why it isn't recommended.
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With