TDAIBBaseDriver

Overview

The TDAIBBaseDriver class is the base class for descendant classes that represent InterBase/Firebird drivers (for example InterBase Express (IBX) or InterBase Objects (IBO)).

The TDAIBBaseDriver class can be used as the base driver for custom InterBase/Firebird drivers. 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 override

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 override safecall

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 the Interbase 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 override

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 override safecall

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 the Interbase 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

 

  • InterBase
  • Firebird
  • TDAEFIBDriver
  • TDAEIBDACDriver
  • TDAEIBODriver
  • TDAEIBXDriver