Throwing and catching exceptions

In This Topic

Error handling in EPLAN is preferably done using exceptions. The API framework provides the BaseException base class that provides you access to the error handling of EPLAN.

If an exception object of this type is thrown, the EPLAN framework catches the exception and writes the data to the system error management or shows the error message in the EPLAN error dialog.

Eplan.EplApi.Base.BaseException exc2= new Eplan.EplApi.Base.BaseException(
                                                "Error from CSharpAction thrown as exception",
                                                Eplan.EplApi.Base.MessageLevel.Error);

throw exc2;

Dim exc2 As New Eplan.EplApi.Base.BaseException("Error from VBAction thrown as exception", _
                                                  Eplan.EplApi.Base.MessageLevel.Error)
Throw exc2

Of course, you can also catch exceptions in your API application and evaluate them, e.g. to display your own error message.

// Test wrong settings name (throws BaseException that is handled here)
try
{
    String strGuiLanguage= Settings.GetStringSetting("USER.SYSEM.GUI.LANGUAGE", 0);
    new Decider().Decide(EnumDecisionType.eOkDecision, "The current GUI language is: "+ strGuiLanguage, "", EnumDecisionReturn.eOK, EnumDecisionReturn.eOK);
}
catch (BaseException exc)
{
    String strMessage= exc.Message;
    new Decider().Decide(EnumDecisionType.eOkDecision, "Exception: " + strMessage, "", EnumDecisionReturn.eOK, EnumDecisionReturn.eOK);
}

' Test wrong settings name (throws BaseException that is handled here)
Dim dec As Decider = New Decider
Try
   Dim strGuiLanguage As String = Settings.GetStringSetting("USER.SYSEM.GUI.LANGUAGE", 0)
   dec.Decide(EnumDecisionType.eOkDecision, "The current GUI language is: "+  strGuiLanguage, "", EnumDecisionReturn.eOK, EnumDecisionReturn.eOK)
Catch exc As BaseException
   Dim strMessage As String = exc.Message
   dec.Decide(EnumDecisionType.eOkDecision, "Exception: " + strMessage, "", EnumDecisionReturn.eOK, EnumDecisionReturn.eOK)
End Try

Use the Eplan Global Support Portal for feedback and support