FCExceptionBase Class
FCExceptionBase is the base exception from which all other First Choice exception classes derive. It provides pluggable error message strings which allows for easy runtime customization and localization of error messages.
Syntax
'Declaration
<SerializableAttribute()>
Public MustInherit Class FCExceptionBase
Inherits System.ApplicationException
[SerializableAttribute()]
public abstract class FCExceptionBase : System.ApplicationException
Remarks
Notes to implementors:
FCExceptionBase will attempt to load default string resources from an embedded resource in your derived class' assembly called "Your.Assembly.Name.ErrorStrings.txt". The format of this file is:
MESSAGEID = This would be your error message with {0} replacement variables
If you wish to override this behavior and manage the resource loading manually, you can override the GetResourceData() and GetErrorMessageFormat() protected methods.
It is recommended that you use unique error numbers every time you throw an exception based on FCExceptionBase. You should choose a range of error numbers and stay consistent in using them.
First Choice has reserved error numbers 0 to 1,073,741,824 (0x4000000 hex). Customers should use positive numbers above this range. An easy way to assure this is to always OR your error numbers with 0x4000000.
IMPORTANT: It is important to note that even if you override GetErrorMessageFormat, if a custom message provider is set using SetMessageProvider, the custom message provider will be used before your override of GetErrorMessageFormat. If the custom message provider is unable to load a message, GetErrorMessageFormat will be called next.
Inheritance Hierarchy
System.Object System.Exception System.ApplicationException FChoice.Common.FCExceptionBase FChoice.Common.CommonException FChoice.Common.FCInvalidConfigurationException FChoice.Common.FCLicenseException FChoice.Common.InvalidLoggingConfigException FChoice.Common.State.StateManagerException FChoice.Foundation.Clarify.ClarifyException FChoice.Foundation.Clarify.Compatibility.CompatibilityException FChoice.Foundation.Clarify.Workflow.WorkflowException FChoice.Foundation.FoundationException
Requirements
Namespace: FChoice.Common
Platforms: Windows 2000, Windows XP, Windows Server family
Assembly: FChoice.Common (in C:\dovetail\dovetail-sdk\build\Release\FChoice.Common.dll)
Reference
FCExceptionBase Members FChoice.Common Namespace FChoice.Common.FCExceptionBase FChoice.Common.CommonException FChoice.Common.FCInvalidConfigurationException FChoice.Common.FCLicenseException FChoice.Common.InvalidLoggingConfigException FChoice.Common.State.StateManagerException FChoice.Foundation.Clarify.ClarifyException FChoice.Foundation.Clarify.Compatibility.CompatibilityException FChoice.Foundation.Clarify.Workflow.WorkflowException FChoice.Foundation.FoundationException
Requirements
Namespace: FChoice.Common
Platforms: Windows 2000, Windows XP, Windows Server family
Assembly: FChoice.Common (in C:\dovetail\dovetail-sdk\build\Release\FChoice.Common.dll)