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.
}
}
}
}