#Win8Dev Tutorial: Programmatically download a File in WinRT apps


If you are a Win8Dev and building a Windows 8/WinRT application, you might want to download a file asynchronously from a web location. The job is very easy in Silverlight and in this case too but you just need to know the way, the APIs and the configuration settings.

 

Many developers already faced the difficulty to download a file in their WinRT apps and hence I thought to share the code with the API details in this post.

 

API Info and Configuration Settings

Microsoft exposes a sealed class named “BackgroundDownloader” present under “Windows.Networking.BackgroundTransfer” namespace, which provides APIs to download any file from a remote location asynchronously. Before going further with the code and the API, let us discuss about the configuration settings. Without proper configuration the code will not work.

 

First of all, you have to open the “Package.appxmanifest” file and navigate to “Capabilities” tab. There you will see an option named “Internet (Client)” already checked. If it is not checked, check it first. Then check another option named “Picture Library” as we are going to save the downloaded file to the picture library. If you want to chose “Documents Library” or “Removable Storage”, check the appropriate capability in this screen.

 

In the Capabilities tab, select Internet (Client) and Pictures Library both

 

 

How to download a file in WinRT application?

Our next step is to play with the code. Let us create an asynchronous method of type “Task<StorageFile>” and pass few parameters to it like file Uri that we are going to download, storage folder and a name of the file.

 

Now create a blank file with the specified name in the storage folder that we mentioned. Assign proper CreationCollisionOption to set proper attributes to it. CreationCollisionOption specifies what to do if a file with the desired name already exists in the current folder. Here is the enum structure for your reference:

 

public enum CreationCollisionOption
{
    GenerateUniqueName, // generates unique file name if the file already exists
    ReplaceExisting, // replaces any existing file with the specified name
    FailIfExists, // escapes without doing anything if the file is already present
    OpenIfExists, // open the existing file
}

 

Then create an instance of the BackgroundDownloaded class which configures downloads prior to the actual creation of the download operation using CreateDownload method.

 

Pass the URL of the file that you are going to download in your device and call the CreateDownload method. Then start the downloading process by calling the StartAsync() method. Here is the complete code which will provide you more inner details of the download process:

 

private async Task<StorageFile> SaveFileAsync(Uri fileUri, StorageFolder folder, string fileName)
{
    // create the blank file in specified folder
    var file = await folder.CreateFileAsync(fileName, CreationCollisionOption.ReplaceExisting);
 
    // create the downloader instance and prepare for downloading the file
    var backgroundDownloader = new BackgroundDownloader();
    var downloadOperation = backgroundDownloader.CreateDownload(fileUri, file);
 
    // start the download operation asynchronously
    var result = await downloadOperation.StartAsync();
 
    return file;
}

 

That’s all about the code. Now when you call the SaveFileAsync method mentioned above with proper parameters, it will start downloading the specified file in the specified directory. By default, it will store the file in the root directory of the specified folder but if you want to place it in a different folder within the same directory, you have to explore a bit more about the StorageFolder class. You can find more about handling files and folders in WinRT here: “Handling Files and Folders in your WinRT apps”.

 

I hope that the post was useful to you to understand how to programmatically download a file in Windows 8, WinRT application asynchronously. Don’t forget to check out my other Windows 8, WinRT application development tutorial. Connect with me on Twitter, Facebook and Google+ for more technical updates and news. Also, subscribe to my blog’s RSS feed and email newsletter.


If you have come this far, it means that you liked what you are reading. Why not reach little more and connect with me directly on Twitter , Facebook , Google+ and LinkedIn . I would love to hear your thoughts and opinions on my articles directly. Also, don't forget to share your views and/or feedback in the comment section below.

3 comments

  1. Thank you Kunal for sharing the code and discussing the usage in brief.

    ReplyDelete
    Replies
    1. Thank you Rajat for the feedback. Much appreciated. I hope, you liked the topic.

      Delete
  2. i want to access document library but my manifest file have no any option to access to document library

    ReplyDelete


 
© 2008-2016 Kunal-Chowdhury.com - Microsoft Technology Blog for developers and consumers | Designed by Kunal Chowdhury
Back to top