exception_object.Qualifier Property

Sets and gets the error message qualifier for a general Exception.

exception_object.Qualifier =<new_value>
-or-
...exception_object.Qualifier

Prerequisites

Only valid for general Exceptions.  Not valid for robot Exceptions.

Parameters

None

Remarks

For general Exceptions, the Qualifier property specifies an additional number that can be used to further refine the meaning of an error condition.  This value is stored as a 16-bit unsigned number and can range from 0 to 65535.  E.g, when the error code is -786 (Project generated error), the Qualifier property can be used by the Project to convey which of several different special error conditions was detected. When a New Exception is created, it defaults to a general Exception with a Qualifier property of 0.  When an Exception is changed from a robot to a general type, the Qualifier value is reset to 0.

Examples

Dim excl As New Exception ' Create new general exception
excl.ErrorCode = -786 ' *Project generated error*
excl.Qualifier = 8 ' Specify the qualifier
Console.WriteLine(excl.Message) ' *Project generated error*: 8

See Also

Exception Handling | exception_object.RobotError