Record.TransferFields(var Record, Boolean, Boolean) Method
Version: Available or changed with runtime version 4.2.
Copies all matching fields in one record to another record.
Syntax
Record.TransferFields(var FromRecord: Record, InitPrimaryKeyFields: Boolean, SkipFieldsNotMatchingType: Boolean)
Parameters
Record
Type: Record
An instance of the Record data type.
FromRecord
Type: Record
The record from which to copy.
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.
SkipFieldsNotMatchingType
Type: Boolean
Specifies whether fields where the field type on the source record do not match the field type on the target record should be ignored.
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 aren't fulfilled, and SkipFieldsNotMatchingType is set to false, a runtime error will occur.
Note
When using TransferFields, errors will only occur if there's a mismatch between fields originating from the same extension. Fields from different apps don't cause TransferFields to fail due to type mismatches. This behavior is to ensure that the addition of new extensions doesn't disrupt the operation of existing code.
Note
Fields are assigned, such as DestinationRecord.Field := SourceRecord.Field, which won't call the OnValidate trigger on the destination field. To assist with validation when using the TransferFields method, the TypeHelper codeunit contains a TransferFieldsWithValidate method.