Asynchronous programming (Windows Runtime apps)
[This article is for Windows 8.x and Windows Phone 8.x developers writing Windows Runtime apps. If you’re developing for Windows 10, see the latest documentation]
Using asynchronous programming helps your app stay responsive when it does work that might take an extended amount of time. For example, an app that downloads content from the Internet might spend several seconds waiting for the content to arrive. If you use a synchronous method on the UI thread to retrieve the content, the app is blocked until the method returns. The app won't respond to user interaction, and because it seems non-responsive, the user might become frustrated. A much better way is to use asynchronous programming, where the app continues to run and respond to the UI while it waits for an operation to complete.
Asynchronous programming in the Windows Runtime
Many Windows Runtime features like the MediaCapture APIs and StorageFile APIs are exposed as asynchronous APIs. By convention, the names of asynchronous APIs end with "Async" to indicate that part of their execution may take place after the API has been invoked.
When you use asynchronous APIs in your Windows Runtime app, your code makes non-blocking calls in a consistent way. When you implement these asynchronous patterns in your own API definitions, callers can understand and use your code in a predictable way.
Here are some common tasks that require calling asynchronous Windows Runtime APIs.
Displaying a message dialog
Working with the file system, displaying a file picker
Sending and receiving data to and from the Internet
Using sockets, streams, connectivity
Working with appointments, contacts, calendar
Working with file types, such as opening Portable Document Format (PDF) files or decoding image or media formats
Interacting with a device or a service
With Windows Runtime asynchronous APIs, you don't need to manage threads explicitly or interact directly with the underlying implementation.
Each programming language supports the asynchronous pattern for the Windows Runtime in its own way:
|Programming language||Asynchronous representation|
|C#||async keyword, await operator|
|Visual Basic||Async keyword, Await operator|
|C++/CX||task class, .then method|
A promise object represents a value that will be fulfilled in the future. In the Windows Runtime you get a promise object from a factory function, which by convention has a name that ends with "Async".
In many cases, calling an asynchronous function is almost as simple as calling a conventional function. The difference is that you use the then or the done method to assign the handlers for results or errors and to start the operation.
Asynchronous patterns in Windows Runtime apps using C# and Visual Basic
A typical segment of code written in C# or Visual Basic executes synchronously, meaning that when a line executes, it finishes before the next line executes. There have been previous Microsoft .NET programming models for asynchronous execution, but the resulting code tends to emphasize the mechanics of executing asynchronous code instead of focusing on the task that the code is trying to accomplish. The Windows Runtime, .NET framework, and C# and Visual Basic compilers have added features that abstract the asynchronous mechanics out of your code. For .NET and the Windows Runtime you can write asynchronous code that focuses on what your code does instead of how and when to do it. Your asynchronous code will look reasonably similar to synchronous code. For more info, see Quickstart: Calling asynchronous APIs in C# or Visual Basic.
Asynchronous patterns in Windows Runtime apps with C++
Quickstart: Calling asynchronous APIs in C# or Visual Basic
Asynchronous Programming with Async and Await (C# and Visual Basic)