ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
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
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
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: automatic error and exception handling works only for the processing for which it is 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, ...
  2. In the code header, click on "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 lines of code following this statement will be run when an exception occurs in the previous lines of code (or in a process called by these lines of code).
For example:
CASE EXCEPTION:
// Affichage d'un message d'erreur
Error("Une erreur fatale a été détectée.", ExceptionInfo(), "", "Arrêt de la procédure.")
// Gestion de cette erreur
...
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.
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: 09/19/2024

Send a report | Local help