//The ImageGearAPI calls OpenArtDocument of ImageDataProvider to get an
//ArtDataConnection derived object.For SQL based provider,
//it is recommended that you open a database connection in the
//constructer of the ArtDataConnection derived class.
ImageGear.Web.DataProviders.ArtDataConnection artconnect =
           ImageGear.Web.DataProviders.ImageDataProvider.OpenArtData();
     
//The ImageGearAPI calls the ImageDataProvider ArtDataConnection.Open to open
//the required document
using (ImageGear.Web.DataProviders.ArtDocumentDataConnection document =  artconnect.OpenDocument(documentIdentifier))
{
    //Since the ImageGearAPI needs to save the annotations data, it needs
    //to get a current copy from the repository to do the merge with what
    // has just been updated. After that it needs to update the repository.
    // This operation requires use of a TransactionScope to make sure this
    // data is not updated by another user when this process is taking place.
    using (TransactionScope Scope = new TransactionScope())
    {
           //The ImageGear API reads the document first by calling the
           // provider ArtDocumentDataConnection.Read()
           System.IO.Stream stream =  document.Read();
 
           // The ImageGear API does the merge operations
           // System.IO.Stream artStream = ....;
   
           //The data is merged and now the data is written to the
           //repository by calling the provider
           //artDocumentdataConnection.Write
           document.Write(artStream);
           //This call will cause the data to be finally committed.
           //If you are using non-transactional system for data storage
           //then you must implement the IEnlistmentNotification interface.
           //The system will call Commit member of this interface to store
           //the data. If there is a processing error before this point then
           //this interface’Rollback method will be called in which case
           //annotation data can not be saved. It is not necessary to
           //implement this interface when using transactional repository
           //systems like the transactional databases.
           Scope.Complete();
    }
}
    // The Server API disposes the ArtDocumentDataConnection derived and
    // ArtDataConnection derived Objects. The SQL connections should be
    // disconnected at this point.
    artconnect.Dispose();