CurrentRecord (Record function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
m (1 revision)
(No difference)

Revision as of 17:56, 14 July 2011

Create a Record object from current record in For loop or Recordset (Record class)


CurrentRecord is a shared function that acts as a constructor.

Syntax

%record = [%(Record In filOrGrp name):]CurrentRecord[( [lockStrength], - [LoopLockStrength= lockStrength])] Throws RecordLockingConflict

Syntax terms

%(Record) Since this is a shared method, this method object can be the class name, Record, in parentheses, or it can be a declared Record object variable, which must have the same file or group context as the For loop within which CurrentRecord is invoked.
lockstr The value of a Lockstrength enumeration: None, Share, or Exclusive. These correspond to standard Model 204 record-locking levels, as described below. The default lock strength of the new Record object is Share.
None
Record is not locked.
No locks are held on the object, so there is no conflict with others holding Share or Exclusive locks (readers and updaters may proceed).
Share
Record is share locked.
This level allows other users to hold a Share lock, but not an Exclusive lock (allows readers but not updaters to proceed).
Exclusive
Record is exclusively locked.
This level prohibits others from holding either an Exclusive lock or a Share lock. It is generally used for update.
LoopLockStrength The lock strength to be used for loops on the Record. This is an optional, name required, parameter, and it defaults to None. See "LoopLockStrength for Records". This parameter is available in Sirius Mods 7.0 and later.

Usage notes

  • CurrentRecord must be invoked from inside a record loop that has the same file or group context as declared for the Record object variable.
  • Under Sirius Mods version 6.8 and later, the CurrentRecord method name does not have to be preceded by the class name or by an object variable.
  • For more information and examples, see "Using CurrentRecord to instantiate a Record object".

See also