IsUpdated Operation

Checks if an object has been updated since the key was obtained. This operation returns true if the object has been updated by any user; otherwise, false. Concurrency management prevents a record being changed if it has been subsequently updated. This check proactively prevents that failure.

Method Signature

bool IsUpdated(string key)

Parameters

Parameter Description
key Type: String

The bookmark of the record, including both primary key and concurrency information.

Results

Result name Description
IsUpdated_Result Type: Boolean

Returns true if and only if another user has modified the record.

Faults

SOAP fault message Description
[record name] [field] [value] does not exist. Indicates that the record has been deleted by another user or process after it has been retrieved for this operation.

Usage Example

using System;  
using System.Collections.Generic;  
using System.Text;  

namespace ConsoleApplication  
{  
    // Imports newly generated web service proxy.  
    using WebService;   

    class Program  
    {  
       static void Main(string[] args)  
           {  
              // Creates instance of service and sets credentials.  
              Customer_Service service = new Customer_Service();  
              service.UseDefaultCredentials = true;  

              Customer cust = new Customer();  
              cust.Name = "Customer Name";  
              service.Create(ref cust);  
              cust = service.Read(cust.No);  
              if (!service.IsUpdated(cust.Key))  
           {  
              // Add code here to modify record.  
           }  
        }  
    }  
}  

See Also

Basic Page Operations