📘
TimeLine E3
  • TimeLine E3 Documentation
  • Framework
    • Introduction
    • DataSet Definition
    • Window Handling Object
      • Input/Output arguments
      • Open
      • BindDataControls
      • Item Changes
      • Item Search
      • MenuItemClicked
      • Print
      • ModuleOpened (BlueArrow)
      • BlueArrowArguments
      • New Row
      • Delete Row
      • Save
      • Transactions
      • Locking [deprecated]
      • Locking (new)
      • Resizing a response window
      • ParaPanel
      • Adding DMS Tab to a Module
    • BusinessObject
    • Controls
      • BindingFormat
      • LookupGrid and SearchDef
      • ComboBox
      • RadioButton
      • Multiline Textbox
      • xTextBoxSearch
      • xFileBrowse [v16+]
      • DxDispoColumn
      • DxProgressColumn
      • DxTemplateColumn
      • Change control caption programmatically
      • TabControl
      • Navigation
      • Enable controls programmatically
      • Enable a MenuItem programmatically
      • Filter search values
      • Jumping to another module
      • Messages, Notifications, Log, Exceptions, Translation
      • LoggerSink [deprecated]
      • Log
      • OpenFile, FolderBrowsing and SaveFile
      • Execute Actions while displaying an Hourglass
      • Using Progress
      • Async methods with progress bar
      • Wizard
      • Customizing controls using xBehaviors
      • TLProperty.AllowInReadOnly [v16+]
    • DataSet Operations
    • Business-related functionality
      • Getting the next primary key
      • Hybrids
      • Enums
      • Get Current User
    • SQL
    • SQL (using named parameters)
    • Advanced SQL
    • Expression Binding
    • Server-side logic & customization [v16+]
      • Service Hoster
      • Starting / stopping hosted services
      • Changes to scheduled jobs!
      • Business Object Proxies
      • Business Object API
    • Colors in Expression Bindings [v15+]
    • Theming
      • Icons
  • TimeLine Developer (TLD)
    • Debugging in TLD
    • Targets
    • Custom Project Rework [v16+]
  • TimeLine-specific LL functions
  • Stunnel proxy
    • Pre-requisites
    • 1. Initial setup
    • 2. Generate the server/web certificates
    • 3.a. Generating client certificates using the CSR flow
    • 3.b. Generate client certificates from the server console
    • 4. Setting up the E3 client connection
    • 5. Setting up the browser certificates
  • Configuration
    • Configuring the WCF timeout
  • Troubleshooting the E3 Bridge
  • [Deprecated]
    • TimeLine WEB - deprecated in v16+
      • Prerequisites for running the WASM modules on the server
      • Prerequisites for developing WASM modules with TLD
      • Creating a small web module with TLD
      • Terminal Configuration
    • Customization Examples - deprecated in v16+
    • Codestore [deprecated]
    • Configuring the scheduled jobs timeout - deprecated in v16+
Powered by GitBook
On this page
  • Translation guideline
  • Yes/No
  • LoggerSink
  • Exceptions
  1. Framework
  2. Controls

Messages, Notifications, Log, Exceptions, Translation

Translation guideline

For messages within MessageBox / LoggerSink / throwException interpolated strings ($"...{myVar}...") should not be used.

xMessgeBox.Show and LoggerSink.PushMessage go through l.Translate with success only if they contain strings without parameters.

Any parameter requires an explicit call of l.Translate (which is similar to a string.format command).

Exceptions and messages with arguments need l.Translate.

throw new Exception(l.Translate("Mehrwertsteuer Array konnte nicht berechnet werden."));
xMessageBox.Show(l.Translate("Gebinde nicht vorhanden),....);

Yes/No

answer = xMessageBox.Show(l.Translate("Gebinde nicht vorhanden. Soll es erstellt werden?"), "Abfrage", MessageBoxButton.YesNo);
if (answer == MessageBoxResult.Yes)
{
    //Create container
    this.CreateGebinde(gebindeNr);
    return;
}

LoggerSink

LoggerSink.PushMessage(this, "Speichern erfolgreich.", Severity.Confirmation);

Exceptions

If more than a Message (a string) is needed after an exception occurred, we can use custom exceptions.

Example for creating such an exception:

public class SchichtplanSaveException : Exception
{
    public DataRow faultyRow;

    public SchichtplanSaveException() { }

    public SchichtplanSaveException(string message) : base(message) { }

    public SchichtplanSaveException(string message, DataRow row) : base(message) { faultyRow = row; }

    public SchichtplanSaveException(string message, Exception inner) : base(message, inner) { }
}

Handling the exception:

public override int OnPreSave()
{
    try 
    {
        BusObj.SaveTest();
    }
    catch (SchichtplanSaveException ex)
    {                
        xMessageBox.ShowException(ex, "Speichern abgebrochen.");
        if (ex.faultyRow != null) dxgSchichtplanPos.SelectedRow = ex.faultyRow;
        return -1;
    }

    return base.OnPreSave();
}
PreviousJumping to another moduleNextLoggerSink [deprecated]

Last updated 3 years ago

LoggerSink [deprecated]