DUPLICATE Function (RecordRef)
Duplicates the table that contains the RecordRef.
Syntax
RecordRef := RecordRef.DUPLICATE
Parameters
RecordRef
Type: RecordRef
The RecordRef that identifies the record and the table that you want to duplicate.
Property Value/Return Value
Type: RecordRef
Remarks
The RecordRef that is returned refers to a new record with the same filters, current keys, and marks as the original RecordRef. Any changes that you make to the filters, current keys, and marks of the new record are not observed in the original. This differs from assigning one RecordRef to another RecordRef. If you assign one RecordRef to another RecordRef, then both refer to the same record and changes that you make to one RecordRef are observed in the other RecordRef.
Example
The following example opens table 18 (Customer) as a RecordRef variable named RecordRef1 and uses the DUPLICATE function to copy the filters, current keys and marks from RecordRef1 into a new RecordRef variable named RecordRef2. After the DUPLICATE function is executed, the RecordRef1 and RecordRef2 variables are identical. This example requires that you create the following variables and text constant in the C/AL Globals windows.
| Name | DataType |
|---|---|
| RecordRef1 | RecordRef |
| RecordRef2 | RecordRef |
| Text constant name | ENU value |
|---|---|
| Text000 | 'RecordRef1 refers to the %1 table.\ RecordRef2 refers to the %2 table.' |
RecordRef1.OPEN(18);
RecordRef2 := RecordRef1.DUPLICATE;
MESSAGE(Text000, RecordRef1.CAPTION, RecordRef2.CAPTION);