OriginalValue and UnderlyingValue properties example (VJ++)

Applies to: Access 2013, Office 2013

This example demonstrates the OriginalValue and UnderlyingValue properties by displaying a message if a record's underlying data has changed during a Recordset batch update.

 
// BeginOriginalValueJ 
import com.ms.wfc.data.*; 
import java.io.* ; 
 
public class OriginalValueX 
{ 
 // The main entry point for the application. 
 
 public static void main (String[] args) 
 { 
 OriginalValueX(); 
 System.exit(0); 
 } 
 
 // OriginalValueX function 
 
 static void OriginalValueX() 
 { 
 // Define ADO Objects. 
 Connection cnConn1 = null; 
 Recordset rstTitles = null; 
 Field fldType = null; 
 
 // Declarations. 
 String strCnn = "Provider='sqloledb';Data Source='MySqlServer';" 
 + "Initial Catalog='Pubs';Integrated Security='SSPI';"; 
 BufferedReader in = 
 new BufferedReader (new InputStreamReader(System.in)); 
 
 try 
 { 
 // Open a connection. 
 cnConn1 = new Connection(); 
 cnConn1.open(strCnn); 
 
 // Open recordset for batch update. 
 rstTitles = new Recordset(); 
 rstTitles.setActiveConnection(cnConn1); 
 rstTitles.setCursorType(AdoEnums.CursorType.KEYSET); 
 rstTitles.setLockType(AdoEnums.LockType.BATCHOPTIMISTIC); 
 rstTitles.open("Titles",cnConn1, 
 AdoEnums.CursorType.KEYSET, 
 AdoEnums.LockType.BATCHOPTIMISTIC, 
 AdoEnums.CommandType.TABLE); 
 
 // Set field object variable for Type field. 
 fldType = rstTitles.getField("type"); 
 
 // Change the type of psychology titles. 
 while(!rstTitles.getEOF()) 
 { 
 if(rstTitles.getField("type").getString(). 
 trim().equals("psychology")) 
 fldType.setString("self_help"); 
 rstTitles.moveNext(); 
 } 
 
 // Similate a change by another user by updating 
 // data using a command string. 
 cnConn1.execute("UPDATE Titles SET type = 'sociology' " 
 + "WHERE type = 'psychology'"); 
 
 // Check for changes. 
 rstTitles.moveFirst(); 
 
 while(!rstTitles.getEOF()) 
 { 
 String strOriginalValue = 
 fldType.getOriginalValue().toString().trim(); 
 String strUnderlyingValue = 
 fldType.getUnderlyingValue().toString().trim(); 
 if(!(strOriginalValue.equals(strUnderlyingValue))) 
 { 
 System.out.println("Data has changed!" + "\n\n"); 
 System.out.println("\tTitle ID: " 
 + rstTitles.getField("title_id").getString().trim() + 
 "\n"); 
 System.out.println("\tCurrent value: " 
 + fldType.getString()+ "\n"); 
 System.out.println("\tOriginal value: " 
 + fldType.getOriginalValue().toString()+ "\n"); 
 System.out.println("\tUnderlying value: " 
 + fldType.getUnderlyingValue().toString()+ "\n"); 
 System.out.println("\n\nPress <Enter> to continue.."); 
 in.readLine(); 
 } 
 rstTitles.moveNext(); 
 } 
 // Cancel the update because this is a demonstration. 
 
 rstTitles.cancelBatch(); 
 
 // Restore original values. 
 cnConn1.execute("UPDATE Titles SET type = 'psychology' " 
 + "WHERE type = 'sociology'"); 
 } 
 catch( AdoException ae ) 
 { 
 // Notify user of any errors that result from ADO. 
 
 // As passing a Recordset, check for null pointer first. 
 if (rstTitles!= null) 
 { 
 PrintProviderError(rstTitles.getActiveConnection()); 
 } 
 else 
 { 
 System.out.println("Exception: " + ae.getMessage()); 
 } 
 } 
 
 // System read requires this catch. 
 catch( java.io.IOException je) 
 { 
 PrintIOError(je); 
 } 
 
 finally 
 { 
 // Cleanup objects before exit. 
 if (rstTitles != null) 
 if (rstTitles.getState() == 1) 
 rstTitles.close(); 
 if (cnConn1 != null) 
 if (cnConn1.getState() == 1) 
 cnConn1.close(); 
 } 
 
 } 
 
 // PrintProviderError Function 
 
 static void PrintProviderError( Connection Cnn1 ) 
 { 
 // Print Provider errors from Connection object. 
 // ErrItem is an item object in the Connections Errors collection. 
 com.ms.wfc.data.Error ErrItem = null; 
 long nCount = 0; 
 int i = 0; 
 
 nCount = Cnn1.getErrors().getCount(); 
 
 // If there are any errors in the collection, print them. 
 if( nCount > 0); 
 { 
 // Collection ranges from 0 to nCount - 1 
 for (i = 0; i< nCount; i++) 
 { 
 ErrItem = Cnn1.getErrors().getItem(i); 
 System.out.println("\t Error number: " + ErrItem.getNumber() 
 + "\t" + ErrItem.getDescription() ); 
 } 
 } 
 
 } 
 
 // PrintIOError Function 
 
 static void PrintIOError( java.io.IOException je) 
 { 
 System.out.println("Error \n"); 
 System.out.println("\tSource = " + je.getClass() + "\n"); 
 System.out.println("\tDescription = " + je.getMessage() + "\n"); 
 } 
} 
// EndOriginalValueJ