Record.TransferFields(var Record [, Boolean]) Method

Version: Available or changed with runtime version 1.0.

Copies all matching fields in one record to another record.

Syntax

 Record.TransferFields(var FromRecord: Record [, InitPrimaryKeyFields: Boolean])

Parameters

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

FromRecord
 Type: Record
The record from which to copy.

[Optional] InitPrimaryKeyFields
 Type: Boolean
Default: true If this parameter is true and the records are in the same table, both the timestamp and the Primary Key fields of the destination record will be changed. If this parameter is true and the records are not in the same table, then the Primary Key fields of the destination record will be changed but the timestamp of the destination record will not be changed. If this parameter is false, then neither the timestamp nor the Primary Key fields of the destination record are changed.

Remarks

The TransferFields method copies fields based on the field number on the fields. For each field in Record (the destination), the contents of the field that has the same field number in FromRecord (the source) will be copied, if such a field exists.

The fields must have the same data type for the copying to succeed (text and code are convertible, other types are not). Enum fields are considered being the same data type even on different enum types. There must be room for the actual length of the contents of the field to be copied in the field to which it is to be copied. If any one of these conditions are not fulfilled, a runtime error will occur.

Note

Fields are assigned, such as DestinationRecord.Field := SourceRecord.Field, which will not call the OnValidate trigger on the destination field. To assist with validation when using the TransferFields method, the TypeHelper codeunit contains a TransferFieldsWithValidate method.

See Also

Record Data Type
Get Started with AL
Developing Extensions