ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Exception functions
  • Overview
  • Automatic management of exceptions
  • Implementing the automatic management of exceptions
  • Running the error process ("CASE EXCEPTION:" in the code)
  • Running a procedure of exception process:
  • Functions for automatic management of exceptions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Overview
The management of exceptions can be customized by process.
You can choose to use an automatic exception process or opt for an advanced exception management via the different WLanguage functions.
Important: The automatic management of errors and exceptions operates for the process for which it was defined. To use a global and unique process if an exception occurs, you must use the mechanism of general exceptions.
WEBDEV - Browser code The automatic exception process is used to manage the WLanguage errors. The errors found in the external JavaScript files are not supported.
Automatic management of exceptions

Implementing the automatic management of exceptions

To implement the automatic management of exceptions:
  1. In the code editor, display the process where the exceptions must be managed: initialization code, click code, procedure, etc.
  2. In the code header, click "When exception: by program".
  3. The window that is displayed allows you to specify the type of automatic process to perform:
ExceptionChangeParameter can be used for advanced error management.

Running the error process ("CASE EXCEPTION:" in the code)

If this option is selected, a line of code is added into "CASE EXCEPTION:". The code lines following this statement will be run when an exception occurs in the previous code lines (or in a process called by these code lines).
For example:
CASE EXCEPTION:
// Display an error message
Error("A fatal error was detected.", ExceptionInfo(), "", "Stop the procedure.")
// Manage this error
...
This option is recommended to group all the exception processes that may occur.

Running a procedure of exception process:

If this option is selected, the specified procedure will be automatically run to process the error when an exception occurs in the current process (or in the processes called by the current process). This option is recommended if a procedure used to process the exceptions is already found in your application. This procedure will be automatically called when an exception occurs. No test to run.
This procedure can return one of the constants found in the table below.
Depending on the constant returned, WINDEV, WEBDEV or WINDEV Mobile will perform the corresponding process.
opCancelRestarts the exception
opEndProcessThe function that triggered the error returns an error and the current process stops. Equivalent to the SetFocusAndReturnToUserInput function.
opEndProgramThe function that triggered the error returns an error and the program stops. Equivalent to the EndProgram function.
opRelaunchProgramEnds the application and automatically restarts the application.
AndroidAndroid Widget Java This constant is not available.
Functions for automatic management of exceptions
ExceptionChangeParameterConfigures the automatic behavior that will be implemented if an exception occurs in the current process.
ExceptionDisplayDisplays the standard window of exceptions with the content of the current exception.
ExceptionEnableRe-enables the current exception process if the exception was corrected.
ExceptionInfoRetrieves information about the current exception.
ExceptionPropagatePropagates an exception.
ExceptionRestoreParameterRestores the exception process of a process.
ExceptionThrowArtificially triggers the security mechanism of WLanguage by throwing an exception.
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 01/26/2023

Send a report | Local help