Transactions

A transaction is defined as a set of independent operations that are performed as an atomic operation, meaning that the operations succeed or fail as a whole. Because a transaction is defined as a single unit of work, they can also be committed or rolled back. TransactionLock method initiate transactions and transaction ends with Unlock method. All methods between these two methods belongs to the transaction and can be committed or rolled back (aborted) depends on what you specified as parameter in Unlock method.

C# example

using System;
using System.Net;
using Independentsoft.Webdav.Exchange;
using Independentsoft.Webdav.Exchange.ContentClass;

namespace Sample
{
    class Program
    {
        static void Main(string[] args)
        {
            NetworkCredential credential = new NetworkCredential("username", "password");
            WebdavSession session = new WebdavSession(credential);
            session.UserMailbox = "https://myserver/exchange/emailaddress";

            Resource resource = new Resource(session);

            ActiveLock activeLock = resource.TransactionLock("https://myserver/exchange/emailaddress/Contacts/john.eml");

            string lockToken = activeLock.Token[0];
            string[] transactionHeader = new string[1];
            transactionHeader[0] = "Transaction: <" + lockToken + ">";

            Contact john = resource.GetContact("https://myserver/exchange/emailaddress/Contacts/john.eml");
            john.TelephoneNumber = "555-666-777";
            john.Department = "Development";

            //set transaction header and save changes
            resource.RequestHeader = transactionHeader;
            resource.SaveItem(john);

            //reset RequestHeader to null
            resource.RequestHeader = null;

            //Commit transaction and unlock contact.
            //If you want to rollback transaction then use "TransactionStatus.Abort" as parameter
            resource.Unlock("https://myserver/exchange/emailaddress/Contacts/john.eml", lockToken, TransactionStatus.Commit);
        }
    }
}

VB example

Imports System
Imports System.Net
Imports Independentsoft.Webdav.Exchange
Imports Independentsoft.Webdav.Exchange.ContentClass

Module Module1
    Sub Main(ByVal args() As String)

        Dim credential As NetworkCredential = New NetworkCredential("username", "password")
        Dim session As WebdavSession = New WebdavSession(credential)
        session.UserMailbox = "https://myserver/exchange/emailaddress"

        Dim resource As Resource = New Resource(session)

        Dim activeLock As ActiveLock = resource.TransactionLock("https://myserver/exchange/emailaddress/Contacts/john.eml")

        Dim lockToken As String = activeLock.Token(0)
        Dim transactionHeader() As String = New String(0) {}
        transactionHeader(0) = "Transaction: <" + lockToken + ">"

        Dim john As Contact = resource.GetContact("https://myserver/exchange/emailaddress/Contacts/john.eml")
        john.TelephoneNumber = "555-666-777"
        john.Department = "Development"

        'set transaction header and save changes
        resource.RequestHeader = transactionHeader
        resource.SaveItem(john)

        'reset RequestHeader to null
        resource.RequestHeader = Nothing

        'Commit transaction and unlock contact.
        'If you want to rollback transaction then use "TransactionStatus.Abort" as parameter
        resource.Unlock("https://myserver/exchange/emailaddress/Contacts/john.eml", lockToken, TransactionStatus.Commit)

    End Sub
End Module

Independentsoft - any library, any programming language

WebDAV .NET for Exchange > Tutorial > Transactions