TDAElevateDBBaseDriver

Overview

The TDAElevateDBBaseDriver class is the base class for descendant classes that represent ElevateDB drivers.

The TDAElevateDBBaseDriver class can be used as the base driver for custom ElevateDB driver. For more information on creating DA drivers, please refer to the article How to create a Data Abstract Driver (Delphi)).

Location


 

CustomizeConnectionObject  protected dynamic    (declared in TDAEDriver)

Provides a way to perform additional procedures after acquiring a connection with the NewConnection methods.

procedure CustomizeConnectionObject(aConnection: TDAEConnection)

Parameters:


Description  protected    (declared in TDAEDriver)

Driver's description.

property Description: string read

DoSetTraceOptions  protected virtual    (declared in TDAEDriver)

Executes actions specific to the implementation to perform event monitoring.

procedure DoSetTraceOptions(TraceActive: Boolean; TraceFlags: TDATraceOptions; Callback: TDALogTraceEvent)

Parameters:

  • TraceActive: Current mode
  • TraceFlags: Set of TDATraceOption
  • Callback: Method to call in various OnTraceEvent event handlers

DriverID  protected    (declared in TDAEDriver)

Returns the driver's ID.

property DriverID: string read

Finalize  protected virtual safecall    (declared in TDAEDriver)

Initializes the driver

procedure Finalize

GetAuxDrivers  protected virtual safecall    (declared in TDAEDriver)

Returns a list of available auxiliary drivers.

procedure GetAuxDrivers(out List: IROStrings)

Parameters:

  • List: List of auxiliary driver names

GetAuxParams  protected virtual safecall    (declared in TDAEDriver)

Returns a list of custom parameters for the specified driver.

procedure GetAuxParams(const AuxDriver: string; out List: IROStrings)

Parameters:

  • AuxDriver: Aux driver name in question
  • List: List of auxiliary parameters

GetAvailableDriverOptions  protected virtual safecall    (declared in TDAEDriver)

Returns a set of available driver options.

function GetAvailableDriverOptions: TDAAvailableDriverOptions

GetAvailableDriverOptionsEx  protected virtual safecall    (declared in TDAEDriver)

Returns a set of available driver options for specific provider.

function GetAvailableDriverOptionsEx(AuxDriver: string): TDAAvailableDriverOptions

Parameters:

  • AuxDriver: Aux driver name in question

GetConnectionClass  protected virtual abstract    (declared in TDAEDriver)

Сreates a concrete implementation of the TDAEConnection.

function GetConnectionClass: TDAEConnectionClass

GetDefaultConnectionType  protected override safecall

Returns ElevateDB string.

function GetDefaultConnectionType(const AuxDriver: string): string

Parameters:

  • AuxDriver: ignored

GetDefaultCustomParameters  protected virtual safecall    (declared in TDAEDriver)

Returns custom driver-dependent parameters.

function GetDefaultCustomParameters: string

GetDescription  protected virtual safecall abstract    (declared in TDAEDriver)

Returns the driver's description.

function GetDescription: string

GetDriverHelp  protected    (declared in TDAEDriver)

Returns the help of the driver by returning the loaded 'DRIVER_HELP' from the resources HTML text.

function GetDriverHelp(aType: TDADriverHelpType): string

Parameters:


GetDriverID  protected virtual safecall abstract    (declared in TDAEDriver)

Returns driver ID

function GetDriverID: string

GetMajVersion  protected virtual safecall    (declared in TDAEDriver)

Returns the driver's major version.

function GetMajVersion: Byte

GetMinVersion  protected virtual safecall    (declared in TDAEDriver)

Returns the driver's minor version.

function GetMinVersion: Byte

Initialize  protected virtual safecall    (declared in TDAEDriver)

Initializes the driver

procedure Initialize

MajVersion  protected    (declared in TDAEDriver)

Driver's major version.

property MajVersion: Byte read

MinVersion  protected    (declared in TDAEDriver)

Driver's minor version.

property MinVersion: Byte read

NewConnection (IDAConnectionManager, TDAConnection): IDAConnection  protected overload safecall    (declared in TDAEDriver)

Creates a new connection with help of the GetConnectionClass class, initializing its corresponding properties with the given aConnectionManager and aConnectionDefinition, and finally calling CustomizeConnectionObject for a created connection. Returns a created connection.

function NewConnection(const aConnectionManager: IDAConnectionManager; aConnectionDefinition: TDAConnection): IDAConnection

Parameters:

  • aConnectionManager: Connection manager
  • aConnectionDefinition: Connection parameters

NewConnection (string, string): IDAConnection  protected overload safecall    (declared in TDAEDriver)

Creates a new aName connection with help of the GetConnectionClass and sets its ConnectionType up to aConnectionType. Returns a created connection.

function NewConnection(const aName: string; const aConnectionType: string): IDAConnection

Parameters:

  • aName: Connection name
  • aConnectionType: Connection type

SetTraceOptions  protected safecall    (declared in TDAEDriver)

Sets trace options.

procedure SetTraceOptions(TraceActive: Boolean; TraceFlags: TDATraceOptions; Callback: TDALogTraceEvent)

Parameters:

  • TraceActive: Current mode
  • TraceFlags: Set of TDATraceOption
  • Callback: Method to call in various OnTraceEvent event handlers

 

Description  protected    (declared in TDAEDriver)

Driver's description.

property Description: string read

DriverID  protected    (declared in TDAEDriver)

Returns the driver's ID.

property DriverID: string read

MajVersion  protected    (declared in TDAEDriver)

Driver's major version.

property MajVersion: Byte read

MinVersion  protected    (declared in TDAEDriver)

Driver's minor version.

property MinVersion: Byte read

 

CustomizeConnectionObject  protected dynamic    (declared in TDAEDriver)

Provides a way to perform additional procedures after acquiring a connection with the NewConnection methods.

procedure CustomizeConnectionObject(aConnection: TDAEConnection)

Parameters:


DoSetTraceOptions  protected virtual    (declared in TDAEDriver)

Executes actions specific to the implementation to perform event monitoring.

procedure DoSetTraceOptions(TraceActive: Boolean; TraceFlags: TDATraceOptions; Callback: TDALogTraceEvent)

Parameters:

  • TraceActive: Current mode
  • TraceFlags: Set of TDATraceOption
  • Callback: Method to call in various OnTraceEvent event handlers

Finalize  protected virtual safecall    (declared in TDAEDriver)

Initializes the driver

procedure Finalize

GetAuxDrivers  protected virtual safecall    (declared in TDAEDriver)

Returns a list of available auxiliary drivers.

procedure GetAuxDrivers(out List: IROStrings)

Parameters:

  • List: List of auxiliary driver names

GetAuxParams  protected virtual safecall    (declared in TDAEDriver)

Returns a list of custom parameters for the specified driver.

procedure GetAuxParams(const AuxDriver: string; out List: IROStrings)

Parameters:

  • AuxDriver: Aux driver name in question
  • List: List of auxiliary parameters

GetAvailableDriverOptions  protected virtual safecall    (declared in TDAEDriver)

Returns a set of available driver options.

function GetAvailableDriverOptions: TDAAvailableDriverOptions

GetAvailableDriverOptionsEx  protected virtual safecall    (declared in TDAEDriver)

Returns a set of available driver options for specific provider.

function GetAvailableDriverOptionsEx(AuxDriver: string): TDAAvailableDriverOptions

Parameters:

  • AuxDriver: Aux driver name in question

GetConnectionClass  protected virtual abstract    (declared in TDAEDriver)

Сreates a concrete implementation of the TDAEConnection.

function GetConnectionClass: TDAEConnectionClass

GetDefaultConnectionType  protected override safecall

Returns ElevateDB string.

function GetDefaultConnectionType(const AuxDriver: string): string

Parameters:

  • AuxDriver: ignored

GetDefaultCustomParameters  protected virtual safecall    (declared in TDAEDriver)

Returns custom driver-dependent parameters.

function GetDefaultCustomParameters: string

GetDescription  protected virtual safecall abstract    (declared in TDAEDriver)

Returns the driver's description.

function GetDescription: string

GetDriverHelp  protected    (declared in TDAEDriver)

Returns the help of the driver by returning the loaded 'DRIVER_HELP' from the resources HTML text.

function GetDriverHelp(aType: TDADriverHelpType): string

Parameters:


GetDriverID  protected virtual safecall abstract    (declared in TDAEDriver)

Returns driver ID

function GetDriverID: string

GetMajVersion  protected virtual safecall    (declared in TDAEDriver)

Returns the driver's major version.

function GetMajVersion: Byte

GetMinVersion  protected virtual safecall    (declared in TDAEDriver)

Returns the driver's minor version.

function GetMinVersion: Byte

Initialize  protected virtual safecall    (declared in TDAEDriver)

Initializes the driver

procedure Initialize

NewConnection (IDAConnectionManager, TDAConnection): IDAConnection  protected overload safecall    (declared in TDAEDriver)

Creates a new connection with help of the GetConnectionClass class, initializing its corresponding properties with the given aConnectionManager and aConnectionDefinition, and finally calling CustomizeConnectionObject for a created connection. Returns a created connection.

function NewConnection(const aConnectionManager: IDAConnectionManager; aConnectionDefinition: TDAConnection): IDAConnection

Parameters:

  • aConnectionManager: Connection manager
  • aConnectionDefinition: Connection parameters

NewConnection (string, string): IDAConnection  protected overload safecall    (declared in TDAEDriver)

Creates a new aName connection with help of the GetConnectionClass and sets its ConnectionType up to aConnectionType. Returns a created connection.

function NewConnection(const aName: string; const aConnectionType: string): IDAConnection

Parameters:

  • aName: Connection name
  • aConnectionType: Connection type

SetTraceOptions  protected safecall    (declared in TDAEDriver)

Sets trace options.

procedure SetTraceOptions(TraceActive: Boolean; TraceFlags: TDATraceOptions; Callback: TDALogTraceEvent)

Parameters:

  • TraceActive: Current mode
  • TraceFlags: Set of TDATraceOption
  • Callback: Method to call in various OnTraceEvent event handlers

 

  • TDAEElevateDBDriver