ExceptionThrow (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Retrieving information about the exception

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ExceptionThrow (Function)

In french: ExceptionDéclenche

Artificially triggers the security mechanism of WLanguage by throwing an exception. Then, this exception can be processed by an exception code written for this purpose. The exceptions are thrown in the WLanguage code only (and not in the framework).

Used in a Webservice, this function allows you to:

stop the current process,
return an error to the external application that uses the Webservice via the standard SOAP protocol.
In the XML code returned by the Webservice, the error message is returned in the "faultstring" tag. The error number is not returned in a specific tag, it is contained in the text of the full error details found in the "detail" tag.
Caution: When consuming this Webservice in a WINDEV, WEBDEV or WINDEV Mobile application, the error must be retrieved by ErrorInfo (and not by ExceptionInfo).

Artificially triggers the PHP security mechanism by throwing an exception.

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android widget mode.

New in version 18

This function is now available in Android widget mode.

Versions 19 and later

This function is now available in Browser code.

New in version 19

This function is now available in Browser code.

Versions 21 and later

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

Example

// -- Déclarations globales de Fenêtre
WHEN EXCEPTION
// Selon le code de l'exception
SWITCH ExceptionInfo(errCode)
// Traitement de l'exception 1
CASE 1: ...
// Traitement de l'exception 2
CASE 2: ...
END
END

// -- Clic de Bouton1
// Déclenche une exception 1
ExceptionThrow(1)

// -- Clic de Bouton2
// Déclenche une exception 2
ExceptionThrow(2)

// -- Clic de Bouton1
// Déclenche une exception d'avertissement
ExceptionThrow(exceptionWarning)

Syntax

ExceptionThrow(<Error number> [, <Message>])

<Error number>: Integer or constant

Number of the error to throw. This number (included between 1 and 1000) is defined by the developer.
Level of the error to throw:
exceptionWarning Warning exception
exceptionError Error exception
exceptionInformation Information exception

<Message>: Optional character string

Message associated with the error.

Remarks

Retrieving information about the exception

The information about the exception is retrieved by ExceptionInfo:

ExceptionInfo(errCode) is used to retrieve the number of the exception.
ExceptionInfo(errMessage) is used to retrieve the message.

Not available in PHP.

Component: wd270vm.dll