ExceptionThrow (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

// -- Window global declarations
WHEN EXCEPTION
// According to the exception code
SWITCH ExceptionInfo(errCode)
// Process the exception 1
CASE 1: ...
// Process the exception 2
CASE 2: ...
END
END

// -- Click of Button1
// Throw an exception 1
ExceptionThrow(1)

// -- Click of Button2
// Throw an exception 2
ExceptionThrow(2)

// -- Click of Button1
// Throw a warning exception
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:
exceptionError Error exception
exceptionInformation Information exception
exceptionWarning Warning 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