If you’ve used async\/await in your applications, you’ll generally await a Task, but you can actually make your own type awaitable. Let’s look at how we’d do this.<\/p>\n
Why are Task’s awaitable?<\/strong><\/p>\n A Task is awaitable, not because it’s a Task type, but its because it supports a specific method name which returns a TaskAwaiter or TaskAwaiter So it’s really that simple, if we want to make our object awaitable we simply define the same method in our type.<\/p>\n What is a TaskAwaiter?<\/strong><\/p>\n A TaskAwaiter is a struct which implements the ICriticalNotifyCompletion interface and the INotifyCompletion interface (the ICriticalNotifyCompletion derives from the INotifyCompletion). But this still wouldn’t make the TaskAwaiter awaitable it also needs the property IsCompleted and the method GetResult – more on this in “the rules for an “Awaiter” type” below.<\/p>\n It does seem strange that these methods weren’t all put into a single interface, but there you have it.<\/em><\/p>\n How do I create a bare minimum awaitable type?<\/strong><\/p>\n Let’s first review the rules for making our type awaitable<\/p>\n and now the rules for an “Awaiter” type<\/p>\n and now let’s put this together into a somewhat pointless type which demonstrates a bare minimum set of requirements to get this type to be awaitable<\/p>\n and now in use, we would have something like this<\/p>\n Note: if you do not call the conitnuation() action in the OnCompleted method the code will block indefinitely.<\/em><\/p>\n The flow of this code goes as follows…<\/p>\n await o<\/em> is called, this calls GetAwaiter<\/em> on MyObject which returns a MyAwaiter<\/em>. Next IsCompleted<\/em> is checked, if the awaiter has already completed then control returns to the line after the await, if it’s false OnCompleted<\/em> is called which basically blocks until the continuation is called, finally the GetResult<\/em> method is called.<\/p>\n Extension methods that are awaitable<\/strong><\/p>\n So we’ve discussed creating our own type, making it awaitable and even creating an awaiter type, but another approach which one might use is creating extension methods and instead of going to the hassle of creating an awaiter type, we’ll simply reuse the TaskCompletionSource type which can be used as a puppet task.<\/p>\n Let’s go straight to some code which I’ve unashamedly lifted from Stephen Toub’s blog post await anything<\/a>.<\/p>\n and we would use this as follows<\/p>\n Looking at the extension method you can see we’re going to use the TaskCompletion classes GetAwaiter to return the awaiter type (in this case a TaskAwaiter References<\/strong><\/p>\n await anything<\/a> If you’ve used async\/await in your applications, you’ll generally await a Task, but you can actually make your own type awaitable. Let’s look at how we’d do this. Why are Task’s awaitable? A Task is awaitable, not because it’s a Task type, but its because it supports a specific method name which returns a TaskAwaiter […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[3],"tags":[],"class_list":["post-3362","post","type-post","status-publish","format-standard","hentry","category-c"],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/3362","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/comments?post=3362"}],"version-history":[{"count":12,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/3362\/revisions"}],"predecessor-version":[{"id":3379,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/3362\/revisions\/3379"}],"wp:attachment":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/media?parent=3362"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/categories?post=3362"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/tags?post=3362"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\r\npublic TaskAwaiter GetAwaiter()\r\n<\/pre>\n
\n
\n
\n
\r\npublic class MyObject\r\n{\r\n public MyAwaiter GetAwaiter()\r\n {\r\n return new MyAwaiter();\r\n }\r\n}\r\n\r\npublic struct MyAwaiter\r\n{\r\n public void OnCompleted(Action continuation)\r\n {\r\n continuation();\r\n }\r\n\r\n public bool IsCompleted { get; private set; }\r\n\r\n public void GetResult()\r\n {\t\t\t\r\n }\r\n}\r\n<\/pre>\n\r\nvar o = new MyObject();\r\nawait o;\r\n<\/pre>\n
\r\npublic static TaskAwaiter<int> GetAwaiter(this Process process)\r\n{\r\n var tcs = new TaskCompletionSource<int>();\r\n process.EnableRaisingEvents = true;\r\n process.Exited += (s, e) => tcs.TrySetResult(process.ExitCode);\r\n if (process.HasExited)\r\n {\r\n tcs.TrySetResult(process.ExitCode);\r\n }\r\n return tcs.Task.GetAwaiter();\r\n}\r\n<\/pre>\n\r\nawait Process.Start(\u201cnotepad.exe\u201d)\r\n<\/pre>\n
\nDesign change: new “await” pattern for greater efficiency<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"