AzureTableAccessor 1.0.4

AzureTableAccessor

The abstraction layer for working with Azure DataTables. Implements a repository that contains methods for creating and retrieving entities from the Azure Table Storage

Getting Started

1. Install the package into your project

dotnet add package AzureTableAccessor

2. Create entity to table mapping configuration

class YourEntityTableMappingConfiguration : IMappingConfiguration<YourEntity>
{
    public void Configure(IMappingConfigurator<YourEntity> configurator)
    {
        configurator.PartitionKey(e => e.Id)
                    .RowKey(e => e.RowId)
                    .Property(e => e.SomeProperty)
                    .Content(e => e.SomeAnotherProperty);
    }
}

• Use methods PartitionKey and RowKey to configure mapping of required keys
• Use method Property to configure mapping of searchable property, method supports mapping nested properties
• Use method Content to configure mapping of non searchable property

3. Add the following line to the Startup Configure method.

 services.AddTableClient(options =>
 {
    options.StorageUri = "StorageUri";
    options.StorageAccountKey = "StorageAccountKey";
    options.AccountName = "AccountName";
 }).ConfigureMap(configurator 
      => configurator.Register(new YourEntityTableMappingConfiguration())); // or ConfigureMap(typeof(YourType).Assembly)

4. Inject repository into your service

IRepository<YourEntity> _repository;

await _repository.CreateAsync(entity); //create entity
await _repository.UpdateAsync(entity); //update entity

var results = await _repository.GetCollectionAsync(); //fetch all
var page = await _repository.GetPageAsync(pageSize: 3); //get page
var entity = await _repository.LoadAsync(entity); //load entity
var searchResult = _repository.SingleAsync(e => e.SomeProperty == "condition"); //search single using expression
var searchResults = await _repository.GetCollectionAsync(e => e.SomeProperty == "condition"); //search using expression