CurrentRecord (Record function): Difference between revisions

Revision as of 00:48, 27 April 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.

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

`%(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.

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

@@ Line 1: / Line 1: @@
 {{Template:Record:CurrentRecord subtitle}}
-<var>CurrentRecord</var> is a shared function.
+<var>CurrentRecord</var> is a [[Notation conventions for methods#Shared methods|shared function]] that acts as a constructor.
 ==Syntax==
 {{Template:Record:CurrentRecord syntax}}
@@ Line 8: / Line 8: @@
 <tr><th><var>%(Record)</var></th>
 <td>Since this is a shared method, this method object can be the class name, <var>Record</var>, in parentheses, or it can be a declared <var>Record</var> object variable, which must have the same file or group context as the <var>For</var> loop within which <var>CurrentRecord</var> is invoked.
-Under <var class="product">Sirius Mods</var> version 6.8 and later, the <var>CurrentRecord</var> method does not have to be preceded by any method object, since it acts like a constructor.
-For more information about shared methods, see [["Shared class members"]].
 </td></tr>
 <tr><th>lockstr</th>

Record class	List of Record methods	Record methods syntax
Notation conventions for methods