OneDrive Service

The OneDrive Service provides a simple way to access resources on either OneDrive or OneDrive for Business (Office 365). You can:

  • Authenticate using Microsoft Account, Active Directory or silently using OnlineId
  • Access OneDrive folders and files in the same consistent way as local StorageFolder and StorageFile
  • Perform CRUD operations on OneDrive resources


In order to use the OneDriveService you need to authenticate the user and get an access token

OneDrive (Consumer)

OneDrive (Consumer) gives you two options in order to authenticate:

1) If the user is connected to a Windows session with a Microsoft Account, the service is able to silently get an access token. For that you need to associate your application to the Store (Project->Store->Associate App With Store...)

2) Or you have to register your app - go to - When prompted, sign in with your Microsoft Account credentials. - Scroll to the bottom of the page (Live (SDK)), and click Add App - Enter your app's name and click Create application. - Copy the Application ID - Add a platform and select mobile application - Save

OneDrive for Business

OneDrive for Business requires you to register your app in the Azure Management Portal:

OneDrive For Business you need to register your app from the Azure Management Portal For more information to manualy register your app see go to the following article When registering your application don't forget to add the Office 365 Sharepoint Online application with the "Read and Write user Files" permissions. You should set your Redirect URI to "urn:ietf:wg:oauth:2.0:oob". You may also need to add the following capabilities to your Package.appxmanifest: privateNetworkClientServer; enterpriseAuthentication


Retrieve the root of your OneDrive

// By default the service silently connects the current Windows user if Windows is associated with a Microsoft Account
var folder = await OneDriveService.Instance.RootFolderAsync();


// if Windows is not associated with a Microsoft Account, you need to initialize the service using an authentication provider AccountProviderType.Msa or AccountProviderType.Adal
OneDriveService.Instance.Initialize(appClientId, AccountProviderType.Msa, OneDriveScopes.OfflineAccess | OneDriveScopes.ReadWrite);


// Login
if (!await OneDriveService.Instance.LoginAsync())
    throw new Exception("Unable to sign in");

Retrieving files

// Once you have a reference to the Root Folder you can get a list of all items
// List the Items from the current folder
var OneDriveItems = await folder.GetItemsAsync();
    //Get the next page of items
    OneDriveItems = await folder.NextItemsAsync();   
while (OneDriveItems != null);

Creating folders

// Then from there you can play with folders and files
// Create Folder
var level1Folder = await rootFolder.CreateFolderAsync("Level1");

var level2Folder = await level1Folder.CreateFolderAsync("Level2");

var level3Folder = await level2Folder.CreateFolderAsync("Level3");

Retrieving subfolders

// You can get a sub folder by path
var level3Folder = await rootFolder.GetFolderAsync("Level1/Level2/Level3");

Moving, copying and renaming folders

// Move Folder
var result=await level3Folder.MoveAsync(rootFolder);

// Copy Folder
Var result=level3Folder.CopyAsync(destFolder)

// Rename Folder
await level3Folder.RenameAsync("NewLevel3");

Creating files

// Create new files
var selectedFile = await OpenLocalFileAsync(); // e.g. using file picker
if (selectedFile != null)
   using (var localStream = await selectedFile.OpenReadAsync())
     var fileCreated = await level3Folder.CreateFileAsync(selectedFile.Name, CreationCollisionOption.GenerateUniqueName, localStream);

Creating files - that exceed 4MB

// If the file exceed the Maximum size (ie 4MB) use the UploadFileAsync method instead
var largeFileCreated = await folder.UploadFileAsync(selectedFile.Name, localStream, CreationCollisionOption.GenerateUniqueName, 320 * 1024);

Moving, copying and renaming files

// You can also Move, Copy or Rename a file
await fileCreated.MoveAsync(destFolder);
await fileCreated.CopyAsync(destFolder);
await fileCreated.RenameAsync("newName");

Downloading files

// Download a file and save the content in a local file
var remoteFile=await level3Folder.GetFile("NewFile.docx"); 

using (var remoteStream = await remoteFile.OpenAsync())
     byte[] buffer = new byte[remoteStream.Size];
     var localBuffer = await remoteStream.ReadAsync(buffer.AsBuffer(), (uint)remoteStream.Size, InputStreamOptions.ReadAhead);
     var localFolder = ApplicationData.Current.LocalFolder;
     var myLocalFile = await localFolder.CreateFileAsync($"{oneDriveFile.Name}", CreationCollisionOption.GenerateUniqueName);
     using (var localStream = await myLocalFile.OpenAsync(FileAccessMode.ReadWrite))
         await localStream.WriteAsync(localBuffer);
         await localStream.FlushAsync();

Retrieving file thumbnails

// At last you can get the thumbnail of a file
var stream = await file.GetThumbnailAsync(ThumbnailSize.Large)
Windows.UI.Xaml.Controls.Image thumbnail = new Windows.UI.Xaml.Controls.Image();
BitmapImage bmp = new BitmapImage();
await bmp.SetSourceAsync(streamTodDisplay);
thumbnail.Source = bmp;


OneDrive Service Sample Page

Requirements (Windows 10 Device Family)

Device family Universal, 10.0.10586.0 or higher
Namespace Microsoft.Toolkit.Uwp.Services


NuGet Packages Required


See the NuGet Packages page for complete list.