Dialog.Update([Integer] [, Any]) Method

Version: Available or changed with runtime version 1.0.

Updates the value of a '#'-or '@' field in the active window.


 Dialog.Update([Number: Integer] [, Value: Any])


This method can be invoked without specifying the data type name.


 Type: Dialog
An instance of the Dialog data type.

[Optional] Number
 Type: Integer
Each '#' or '@' field has a specific number. The Number argument tells into which field the Value should be inserted. If you omit this parameter, then all '#' or '@' fields in the active window are updated.

[Optional] Value
 Type: Any
This value or expression can be any simple AL data type such as Boolean, Option, Integer, Decimal, Date, Time, Text, and Code. If you omit this value, then the value from the variable in the OPEN method (Dialog)] call is used.


Dialog windows that are opened by an object are closed when the object terminates.

Dialog windows are automatically sized to hold the longest line of text and the total number of lines.

We recommend the following guidelines:

  • Enter messages as text constants.

  • Write messages using active voice. For example, write “Processing items” instead of writing “Items are being processed.”

  • Align the # field to the left with at least one space character between the text and the variable.


With the Dynamics NAV Client connected to Business Central, you can use @ characters instead of # characters for the String parameter to display the value as percentage and a progress indicator. The percentage value that is displayed is the percentage of the variable value from 0 to 9999. This is not supported in the Business Central Web client.

See Also

Dialog Data Type
Get Started with AL
Developing Extensions