The AL developer preview is still evolving with frequent updates. Follow us on the Dynamics NAV Team Blog for the announcements.

SingleInstance Property

Sets whether a single instance of the codeunit and codeunit variables are instantiated.

Applies To


Property Values

True if only one instance of a codeunit that makes it a single instance codeunit is set; otherwise, false. The default is false.


When you set this property to true on a codeunit, all codeunit variables that use this codeunit use the same instance. That is, all codeunit variables of this codeunit use the same set of internal variables when the code is running on the same client. The codeunit remains instantiated until you close the company.

The following example shows how you can use the SingleInstance property.

Two pages can connect to the same codeunit.

On Page1:


On Page2:

Number := Codeunit1.GetNumber();


The SingleInstance property in Codeunit1 is set to true. Page1 calls a function on Codeunit1 and sets the parameter to 100. Codeunit1 saves this parameter in a local variable. Page2 is now able to get the parameter value (=100) from Codeunit1. A message is displayed.

See Also