Edit

Share via

RecordRef.LoadFields(Integer,...) Method

  • Article

Version: Available or changed with runtime version 6.0.

Accesses the table's corresponding data source and loads the values of the specified fields on the record.

Syntax

[Ok := ]  RecordRef.LoadFields(Fields: Integer,...)

Parameters

RecordRef
 Type: RecordRef
An instance of the RecordRef data type.

Fields
 Type: Integer
The FieldNo's of the fields to be loaded.

Return Value

[Optional] Ok
 Type: Boolean
true if all values were loaded on the record; otherwise, false. If you omit this optional return value and the operation does not execute successfully, a runtime error will occur.

Remarks

This method will trigger a JIT load of the specified fields. The method allows for triggering the JIT load on multiple fields. If the fields are already loaded, another load won't be triggered. Using this method instead of of relying on implicit JIT loads lets you develop for more explicit error handling when a load fails.

Note

Only fields of FieldClass = Normal are supported as input values for the Fields parameter. If fields of FieldClass = FlowFilter or FieldClass = FlowField are passed, the return value will be false if observed; otherwise, a runtime error will occur.

The method is part of the partial records capability for improving performance. Learn more in Using partial records.

Using Partial Records
RecordRef Data Type
Get Started with AL
Developing Extensions