/azure-sdk-for-net

Windows Azure SDK for .NET

Primary LanguageC#Apache License 2.0Apache-2.0

Windows Azure SDK for Windows 8 and .NET 4 (2.0.2)

This SDK allows you to build Windows Azure applications that take advantage of Azure scalable cloud computing resources: table and blob storage, messaging through Service Bus, distributed caching through cache.

For documentation please see the Windows Azure .NET Developer Center.

Features

  • Tables
    • Create/Delete Tables
    • Query/Create/Read/Update/Delete Entities
    • BLOBs
      • Create/Read/Update/Delete BLOBs
      • Queues
        • Create/Delete Queues
        • Insert/Peek Queue Messages
        • Advanced Queue Operations

        Getting Started

        Download

        Option 1: Via Git

        To get the source code of the SDK via git just type:

        git clone git://github.com/WindowsAzure/azure-sdk-for-net.git
        
cd ./azure-sdk-for-net

        Option 2: Via NuGet

        To get the binaries of this library as distributed by Microsoft, ready for use within your project you can also have them installed by the .NET package manager NuGet.

        Install-Package WindowsAzure.Storage

        Requirements

        • Account: To use this SDK to call Windows Azure services, you need to first create an account.
        • Hosting: To host your .Net code in Windows Azure, you additionally need to download the full Windows Azure SDK for .NET - which includes packaging, emulation, and deployment tools.
        • Windows 8 or .NET Framework 4.0

        Dependencies

        The 2.0.2 version depends on three libraries (collectively referred to as ODataLib), which are resolved through the ODataLib (version 5.0.2) packages available through NuGet and not the WCF Data Services installer which currently contains 5.0.0 versions. The ODataLib libraries can be downloaded directly or referenced by your code project through NuGet. The specific ODataLib packages are:
        http://nuget.org/packages/Microsoft.Data.OData/5.0.2
        http://nuget.org/packages/Microsoft.Data.Edm/5.0.2
        http://nuget.org/packages/System.Spatial/5.0.2

        Code Samples

        Note:

        First, include the classes you need (in this case we'll include the Storage and Table and further demonstrate creating a table):

        using Microsoft.WindowsAzure.Storage;
using Microsoft.WindowsAzure.Storage.Table;

        To perform an operation on any Windows Azure resource you will first instantiate a client which allows performing actions on it. The resource is known as an entity. To do so for Table you also have to authenticate your request:

        var storageAccount = 
    CloudStorageAccount.DevelopmentStorageAccount;
var tableClient = storageAccount.CreateCloudTableClient();

        Now, to create a table entity using the client:

        CloudTable peopleTable = tableClient.GetTableReference("people");
peopleTable.Create();

        Need Help?

        Be sure to check out the Windows Azure Developer Forums on MSDN if you have trouble with the provided code.

        Feedback

        For feedback related specificically to this SDK, please use the Issues section of the repository.

        For general suggestions about Windows Azure please use our UserVoice forum.

        Learn More