# Azure Blob Storage Instructions for setting up the environment to upload files to Azure Blob Storage. To use the built-in Azure Blob provider that comes with RadCloudUpload, you must: 1. [Add the necessary references](https://www.telerik.com/products/aspnet-ajax/documentation/controls/cloudupload/cloud-storage-providers/azure-blob-storage#adding-references) 2. [Configure the provider](https://www.telerik.com/products/aspnet-ajax/documentation/controls/cloudupload/cloud-storage-providers/azure-blob-storage#configuration) ## Adding References **RadCloudUpload** can upload files to Azure Blob Storage. It is built on the top of [Windows Azure Blob Storage Service in .NET](http://www.windowsazure.com/en-us/documentation/articles/storage-dotnet-how-to-use-blobs-20/). To work properly, the control needs a reference to some of the client libraries included in the [Windows Azure Storage](http://www.nuget.org/packages/WindowsAzure.Storage/) which is a part of [Windows Azure SDK for .NET](http://www.windowsazure.com/en-us/develop/net/). The **Windows Azure Storage** package is distributed through a **NuGet** feed and can be easily installed through the Package Management Console. The following table shows the command to install the Microsoft.WindowsAzure.Storage package based on the Telerik.Web.UI version and targeting .NET Framework. | Telerik.Web.UI version | Targeting .NET 4.0 and later | Targeting .NET 3.5 | | ---------------------- | ----------------------------------------------------- | ----------------------------------------------------- | | >= 2014.1.225 | Install-Package WindowsAzure.Storage -Version 3.0.2 | Install-Package WindowsAzure.Storage -Version 1.7.0.0 | | < 2013.3.1324 | Install-Package WindowsAzure.Storage -Version 1.7.0.0 | Install-Package WindowsAzure.Storage -Version 1.7.0.0 | > caption Example ![NuGet PM Console example for Azure Package](https://www.telerik.com/products/aspnet-ajax/documentation/assets/6e1caf4ffa93e2f5ea81908a08b835cf/cloudupload-azure-nuget.png "NuGet PM Console example for Azure Package") * For version **`3.0.2`**, only the **`Microsoft.WindowsAzure.Storage.dll`** assembly with version **`3.0.2.0`** is used by RadCloudUpload. * For version **`1.7.0.0`**, only the **`Microsoft.WindowsAzure.StorageClient.dll`** assembly with version **`6.0.6002.18488`** is used by RadCloudUpload. > important Newer versions of `Microsoft.WindowsAzure.Storage` packages may not work for RadCloudUpload. File uploads could stop working and the app could throw a `NullReferenceException` from `Telerik.Web.UI.CloudUploadHandler.GetEncryptedText` method. ## Configuration Configuring the Azure Blog Storage provider can be done wither by using the CloudUpload's Wizard, or by adding the necessary configuration entries to the **web.config**. * [CloudUpload Wizard](https://www.telerik.com/products/aspnet-ajax/documentation/controls/cloudupload/cloud-storage-providers/azure-blob-storage#cloudupload-wizard) * [web.config](https://www.telerik.com/products/aspnet-ajax/documentation/controls/cloudupload/cloud-storage-providers/azure-blob-storage#webconfig) ### CloudUpload Wizard From the **RadCloudUpload**'s smart tag choose Azure as provider tag and open the Configuration Wizard: ![CloudUpload Designer Wizard](https://www.telerik.com/products/aspnet-ajax/documentation/assets/ff3f1e0b49946c75f9aa4def8cd5138e/cloudupload-azure.png "CloudUpload Designer Wizard") In the Configuration Wizard dialog enter Azure **Access Key**, **Account Name** and **Blob Container Name**. ![CloudUpload Configuration Wizard for Azure](https://www.telerik.com/products/aspnet-ajax/documentation/assets/c47d439101cc078abded247836c67559/cloudupload-azure-configuration.png "CloudUpload Configuration Wizard for Azure") By specifying the **Uncommitted Files Expiration Period** (TimeSpan Structure), you could easily configure the time, after which the unprocessed files will be removed from the storage. When **Ensure Container** is checked, the control will create a new Container if it doesn't exists. In case it is not checked and the Container doesn't exists - an exception will be thrown. This will add the necessary configuration settings to the project configuration file, however, you can double-check that. For more details, check out the [web.config](https://www.telerik.com/products/aspnet-ajax/documentation/controls/cloudupload/cloud-storage-providers/azure-blob-storage#webconfig) section. ### web.config You can also configure the Azure Provider manually by adding the required entries in the **web.config**. Add the `` and `` entries to the `` element. Fill in the values for the **accountKey**, **accountName** and **blobContainer** attributes of the storage provider. ```web.config
``` > important The `` must be the first child of the `` element. For more details, you can check out the Microsoft Official article [configSections element](https://learn.microsoft.com/en-us/dotnet/framework/configure-apps/file-schema/configsections-element-for-configuration). > > Uploading in Azure is done in chunks of **2MB** in size. In order to upload files larger than 4MB, it is needed to increase the maximum allowed file size. For more details please refer to this [article](https://www.telerik.com/products/aspnet-ajax/documentation/controls/cloudupload/how-to/uploading-large-files). The chunks that were cancelled during the uploading are removed automatically by Azure. > > When older browsers are used (IE9 or below), files are uploaded at once, because chunking is not supported. ## See Also * [Custom Storage Providers](https://www.telerik.com/products/aspnet-ajax/documentation/controls/cloudupload/custom-cloud-storage-providers/overview) * [Custom Azure Blob Storage Provider](https://www.telerik.com/products/aspnet-ajax/documentation/controls/cloudupload/custom-cloud-storage-providers/custom-azure-blob-storage-provider) * [Troubleshooting](https://www.telerik.com/products/aspnet-ajax/documentation/controls/cloudupload/troubleshooting)