LockStrength enumeration: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
<!-- LockingStrength enumeration -->
<!-- LockingStrength enumeration -->
This enumeration is used to indicate the strength of a lock, and is often used in controlling locking for [[Record_class|Records]] and [[Recordset_class|Recordsets]].
This enumeration is used to indicate the strength of a lock, and is often used in controlling locking for [[Record_class|Records]] and [[Recordset_class|Recordsets]]. When an object referencing one or more records is instantiated, the referenced records are locked with a particular lock strength, either implicitly as with the <var>Find All Records</var> and <var>Find And Reserve</var> statements or explicitly as with the [[New_(Record_constructor)|Record]] and [[New_(Recordset_constructor)|Recordset]] class constructors.
 
These are the valid values of this [[Enumerations|enumeration]], which correspond to standard <var class="product">Model 204</var> record-locking levels:
These are the valid values of this [[Enumerations|enumeration]], which correspond to standard <var class="product">Model 204</var> record-locking levels:
<table>
<table>

Revision as of 12:50, 30 August 2012

This enumeration is used to indicate the strength of a lock, and is often used in controlling locking for Records and Recordsets. When an object referencing one or more records is instantiated, the referenced records are locked with a particular lock strength, either implicitly as with the Find All Records and Find And Reserve statements or explicitly as with the Record and Recordset class constructors.

These are the valid values of this enumeration, which correspond to standard Model 204 record-locking levels:

None Object is not locked.
No locks are held on the object, so there can be no conflict with others holding Share or Exclusive locks (readers and updaters may proceed). Find Without Locks statements acquire this type of record lock for Recordsets.
Share Object is locked in share mode.
This level allows other users to hold a Share lock, but not an Exclusive lock (allows readers but not updaters to proceed). Find All Records statements acquire this type of record lock for Recordsets.
Exclusive Object is locked in exclusive mode.
This level prohibits others from holding either an Exclusive lock or a Share lock. It is generally used for update. Find And Reserve statements acquire this type of record lock.

Note: As with all enumerations, the ToString method implicitly converts an enumeration value to a character string whose value is the name of the enumeration value. For more information about methods available to all enumerations, see "Common enumeration methods".