AzureTableAccessor 1.0.5

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
• Use method ToTable to configure custom table name, by default name of entity used as table name

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