Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Asynchronous programming (Windows Store apps)

Using asynchronous programming helps your apps stay responsive when they do work that might take an extended amount of time. For example, an app that downloads information from the Internet might spend several seconds waiting for the information to arrive. If you use a synchronous method on the UI thread to retrieve the information, 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.

For methods that might take a long time to complete, asynchronous programming is the norm and not the exception in the Windows Runtime. JavaScript, C#, Visual Basic, and C++ each provide language support for asynchronous methods.

Asynchronous programming in the Windows Runtime

Many Windows Runtime features like MediaCapture 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 call has returned.

When you use asynchronous APIs in your Windows Store app, your code makes non-blocking calls in a consistent way. When you implement these asynchronous patterns in your code, 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, including displaying a file picker.

  • Sending and receiving data to and from the Internet

  • Sockets, streams, connectivity

  • 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 languageAsynchronous representation
JavaScript promise object, then function
C#async keyword, await operator
Visual BasicAsync keyword, Await operator
Microsoft Visual C++task class, .then method

 

Asynchronous patterns in Windows Store apps with JavaScript

In JavaScript, asynchronous programming follows the Common JS Promises/A proposed standard by having asynchronous methods return promise objects. Promises are used in both the Windows Runtime and Windows Library for JavaScript.

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 Store apps with C# and Visual Basic

A typical segment of code written in C# or Microsoft Visual Basic executes synchronously, meaning that when a line executes, it finishes before the next line executes. Various programming models, such as the Asynchronous Programming Model and the Event Asynchronous Pattern, have been used over the years to enable developers to write asynchronous code. While these models have succeeded in enabling asynchronous execution, 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, Microsoft .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 Store apps with C++

In Visual C++, asynchronous programming is based on the task class, and its then method. The syntax is similar to that of JavaScript promises. The task class class and its related types also provide the capability for cancellation and management of the thread context. For more information, see Asynchronous programming in C++.

The create_async function provides support for producing asynchronous APIs that can be consumed from JavaScript or any other language that supports the Windows Runtime. For more info, see Creating Asynchronous Operations in C++ for Windows Store apps.

Related topics

Asynchronous programming in JavaScript
Quickstart: Calling asynchronous APIs in C# or Visual Basic
Asynchronous Programming with Async and Await (C# and Visual Basic)
Reversi sample feature scenarios: asynchronous code

 

 

Show:
© 2014 Microsoft. All rights reserved.