EngineManagerStartEngine Method

Boots up the application engine.

Namespace:  Dundas.BI
Assembly:  Dundas.BI.Core (in Dundas.BI.Core.dll) Version: 2.0.0.0 (24.3.0.1000)
Syntax
public static void StartEngine()
Exceptions
ExceptionCondition
NoEngineException
Remarks

During startup, any services which have been registered with the engine that implement IRequireInitialization will have their Initialize method called.

After this method is called, EngineState will be Started.

Examples

This example demonstrates how to create the Dundas BI engine start the Dundas BI engine, log on, and shutdown the Dundas BI engine.

C#
using Dundas.BI;
using Dundas.BI.AccountServices;

   ...

// Create the engine.
EngineManager.CreateEngine(
    // Path to the application's data folder. Type: System.String
    @"C:\Program Files\Dundas Data Visualization Inc\Dundas BI\Instances\Instance1\www\BIWebsite\App_Data"
);

try
{
    EngineManager.StartEngine();

    // Create a caller context not associated with any session.
    using(Engine.Current.GetService<ICallerContextService>().CreateAndSetCurrentContext(null))
    {

        LogOnResult logOnResult = Engine.Current.GetService<ILogOnService>().LogOn(
            // The account name. Type: System.String
            "admin",
            // The password. Type: System.String
            "1234",
            // Delete other sessions for the logon to succeed. Type: System.Boolean
            true,
            // Culture to associate with the session, or null to use the default. Type: System.Globalization.CultureInfo
            null
        );

        // Set the current session ID.
        Engine.Current.GetService<ICallerContextService>().CurrentContext.SetCurrentSessionId(
            logOnResult.Session.Id
        );

    }

}
finally
{
  // Shutdown the engine. 
    EngineManager.ShutdownEngine();
}
See Also