
                              Adonis 2.00 (Beta 1)

                        Copyright (c) 1997, 98 Erik Salaj

What's new
----------

Version 1.00 Beta 1 - first version of component
             Beta 2 - corrected some problems with MS SQL server
             Beta 3 - added method OpenADORecordset
             Beta 4 - changes and improvements for ADO 1.5
             Final  - minor improvements
        2.00 Beta 1 - added component TADODatabase
                    - added support for BLOB, MEMO and datetime fields

1. Description
--------------

  Adonis is collection of Delphi 3.0 components for accessing data
  in MS Access, MS SQL Server and other databases through ADO 1.5
  (ActiveX Data Objects).

  Components in Adonis collection:

    TADODataSet  - dataset component similar to TTable and TQuery
    TADODatabase - database component similar to TDatabase

  They benefits are:

  1. Use newest version of ADO (ActiveX Data Objects)

  2. No need for BDE (Borland Database Engine)

  3. Speed - fast access to data without BDE

  4. Full access to ADO (you can use transactions, SQL commands, ...)

  5. Compatibility with standard Delphi data control components (TDBGrid,
     TDBEdit, ...) and components that uses TDataSet (QuickReport, ...)

2. Installation
---------------

  In Delphi 3.0 click menu "Component/Install Component" select "Into new
  package", next enter into dialog box

    Unit file name	"C:\ADO\ADODS.DCU" "C:\ADO\ADO.DCU"
    Package file name	PADODS.DPK
    Package description	Adonis

  and confirm component installation.

3. ADO Examples
---------------

  1. Showing status of ADO Recordset

    uses ADODS, ...

    ShowMessage(IntToStr(ADODataSet.Recordset.Status));

  2. Showing ADO connection information

    uses ADO, ADODS, ...

    ShowMessage((IDispatch(Variant(ADODataSet.Recordset).ActiveConnection) as ADO.Connection).ConnectionString);

4. Fields mapping
-----------------

  ADO		     Delphi
  -----------------------------
  adBoolean	     ftBoolean
  adChar	     ftString
  adCurrency	     ftCurrency
  adDBTimeStamp      ftDateTime
  adDouble	     ftFloat
  adInteger	     ftInteger
  adLongVarBinary    ftBlob
  adLongVarChar      ftMemo
  adSingle	     ftFloat
  adSmallInt	     ftSmallint
  adUnsignedSmallInt ftWord
  adVarChar	     ftString

5. Important TADODataSet properties
-----------------------------------

  Database        - link to TADODatabase component, if entered then
                    DatabaseConnect property is ignored

  DatabaseConnect - ADO connect information (driver, database, password, ...)
                    example for Access 97: "DRIVER={Microsoft Access Driver (*.mdb)};DBQ=C:\database.mdb;PWD=admin"
                    example for ODBC DSN:  "DSN=mydsn;UID=sa"

  TableName       - table or query name
                    example: "MyTable"

  Sort            - ORDER BY clause for command SELECT
                    example: "SALARY DESC, EMPLOYEE"

  Filter          - WHERE clause for command SELECT
                    example: "SALARY > 1000"

  SQL             - SQL command, if entered then TableName, Sort and Filter
                    properties are ignored
                    example: "SELECT * FROM MyTable WHERE SALARY > 1000
                              ORDER BY SALARY DESC, EMPLOYEE"

6. Important TADODatabase properties
------------------------------------

  DatabaseConnect - see DatabaseConnect property of TADODataSet

  Password        - user password

  UserName        - user name

7. Limitations
--------------

  Ranges, Keys, Indexes, Constrains and some others methods and
  properties are not implemented.

8. Ordering
-----------

  Trial version of Adonis is free. It has one limitation - requires
  running Delphi 3.0.

  Unlimited version you receive by E-mail on registration and payment via
  www.shareit.com.

  After registering you get free bug fix upgrade for a year and E-mail support.

  Prices:

    Single licence            USD 160.-
    Additional licences   N x USD  80.-
    Upgrade from any previous version - contact me for special price

  Additional licences are needed for developer computers only, number
  of distributed components in applications is not limited.

  Use this component at your own risk.

  Please send any comments and ideas to

  Erik Salaj
  erik@dodo.sk

  WEB: www.ec-servis.box.sk/erik
  FTP: ftp://www.ec-servis.box.sk/erik

DISCLAIMER OF WARRANTY
----------------------

COMPONENTS ARE SUPPLIED "AS IS" WITHOUT WARRANTY OF ANY KIND. THE AUTHOR
DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION,
THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE. THE AUTHOR
ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT
FROM THE USE OF COMPONENTS.