Licensing

There are 2 ways of using DataStore as as an in-process library or as a separate process. The following table describes the API available in both cases depending on whether or not the machine has an active licence.

In-Process Separate Process
Activated Full API Full API
Not Activated Restricted API None
Restricted API

The Restricted API allows data to be stored and retrieved, but no changes made to the Data Model.

This means in practice that you can build and distribute an app with based on a particular Data Model, but you cannot change that model once it has been installed on a users machine. It also means you must distribute a DataStore with your app.

This is typically the scenario you would choose if you were developing the app using the Object Model Generator. The sample Windows Phone app shows how this done.

Should you wish to upgrade your app with a change to the Data Model then you need to include a DataStore that contains the new Data Model. The upgrade procedure will need to copy the data across.

Not available in Restricted API

Instance.Create

Connection.AddItemType

ItemType.Delete

ItemType.SetName

ItemType.SetDescription

ItemType.AddAssociationType

ItemType.AddAttributeType

AssociationType.AddAssociate

AssociationType.Delete

AssociationType.SetName

AssociationType.SetDescription

AttributeType.Delete

AttributeType.SetName

AttributeType.SetDescription