ExceptionThrow (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Standard functions / Exception management functions

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.

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