This project is read-only.

This Toolkit is now deprecated and is now

superseded by Windows Azure Mobile Services

During the early previews of Windows 8, the Windows Azure Toolkit for Windows 8 provided developers with the first support for building backend services for Windows Store apps using Windows Azure.  The main areas of feedback we received from mobile developers was that they wanted a turn-key set of services for common functionality such as notifications, auth, and data.   Windows Azure Mobile Services directly reflects this feedback by enabling developers to simply provision, configure, and consume scalable backend services. The downloads for this toolkit will be removed on the week of Feb 1st 2013.  Future improvements will be channeled into Windows Azure Mobile Services rather than this toolkit. 

To get started with Mobile Services, sign up for a Windows Azure account and receive 10 free Mobile Services.

Raw Notifications Sample – C# and JavaScript

In addition to the notification samples described previously, the toolkit also includes two sample applications—one written in C# and XAML and another written in HTML and JavaScript—that show how to send and receive raw notifications, as well as toast, badge, and tile notifications. Raw notifications are push notifications with no associated UI that perform a background task for the application. These samples do not use ACS-secured endpoints and are simpler to set up.

You can find the source code for the C# and Javascript samples in the Samples\RawNotifications.CSharp and Samples\RawNotifications.JS folders, respectively.

Important: Setting up the Raw Notifications Sample

Before running these samples, you need to follow the steps described below to register the Metro style application.

  1. To register your application, go to the Windows Live Application Management site for Metro style apps at and sign in with your Windows Live ID.
  2. In the Windows Push Notifications & Live Connect page, enter the following information and click I Accept to submit the registration form.

    For the C# sample:

    Package Display Name



    CN=, O=TESTING ONLY, OU=Windows Azure DevFabric

    For the JavaScript sample:

    Package Display Name



    CN=, O=TESTING ONLY, OU=Windows Azure DevFabric


  3. Once you register the application, make a note of the values shown in the portal for Client Secret, Package Name and Package SID.


  4. Now, open the Configuration.xml file in the Samples\RawNotifications.CSharp folder for the C# project or the Samples\RawNotifications.JS folder for the JavaScript project in a text editor.
  5. Locate the Notifications section and replace the placeholders for ClientSecret, PackageName, and PackageSID with the values obtained from the portal.
  6. Execute the SetupSample.cmd script, also located in the Samples\RawNotifications.CSharp folder for the C# project or the Samples\RawNotifications.JS folder for the JavaScript project, to launch a tool that will configure the sample for you.
  7. When prompted, confirm that you have entered the required information in the configuration file.


  8. If you are prompted by a User Account Control dialog, click Yes.
  9. Wait until the tool finishes configuring your sample.



Running the Raw Notifications Sample

To run these samples, you must run both the client and the server application projects.

  1. Open Visual Studio 2010 as an administrator.


    At the time of writing, only Visual Studio 2010 supports Windows Azure cloud projects so you currently need to use this edition to launch the server application. This will change in a future release of the Windows Azure tools when support for Visual Studio 11 is enabled.

  2. Open the RawNotifications.Backend.sln solution located in the Samples\RawNotifications.CSharp folder for the C# project or in the Samples\RawNotifications.JS for the JavaScript project.
  3. Make sure that the start-up project of the solution is the cloud project. To set the start-up project, right-click the RawNotifications.Backend project in Solution Explorer and select Set as StartUp Project.
  4. Press F5 to launch the application in the compute emulator and open a browser window that shows its start page.
  5. Now, open Visual Studio 11 and open the RawNotifications.CSharp.sln solution located in the Samples\RawNotifications.CSharp folder for the C# sample or in the Samples\RawNotifications.JS folder for the JavaScript sample.
  6. Press F5 to launch the Metro style client application.
  7. In the client application, click Register to send a request to Windows Push Notification Services (WNS) for opening a notification channel and registering it with the back end service running in the cloud project.
  8. Once a channel is registered, the Registration Channel text area updates to show its URL.


  9. Then, click Enable to request lock screen privileges. This allows the application to run in the background and is required for the application to receive raw notifications.


  10. Return to the browser window showing the Push Notifications page and refresh it. Notice that the UI now lists the newly registered client.


  11. You may now send notifications to the client application by clicking the Send Notification button. To learn how to use this feature, see Using the Windows 8 Cloud Application Services Application. The application lists the raw notifications it receives in reverse chronological order.


  12. A background task can process raw notifications while the application is not running. To test this feature, close the application by using the close gesture or pressing Alt + F4.
  13. Now, return to the cloud application and send one or more raw notifications.
  14. Next, restart the application by pressing F5 in Visual Studio or by clicking its tile in the Start screen. When the application restarts, it will process all the notifications that it received while it was not running and show them in its UI.

Last edited Jan 21, 2013 at 8:58 PM by nharris, version 8


No comments yet.