Objekt TKAPADOTable

Objekt TKAPADOTable

Tato třída slouží pro manipulaci s databázovými tabulkami prostřednictvím rozhraní ADO. Je možné otevřít tabulku dostupnou prostřednictvím ADO (dle ConnectionString), procházet záznamy tabulky, filtrovat záznamy, načítat či měnit hodnoty z jednotlivých polí záznamu apod. Komponenty potřebují, aby ADO 2.1 (nebo vyšší) bylo instalováno na hostitelském počítači. Navíc, klientský software pro cílový databázový systém (jako například Microsoft SQL Server) musí být nainstalován (ovladač OLE DB nebo ovladač ODBC specifický pro daný databázový systém).

TKAPADOTable = class(TDataset)
 constructor Create;
 function ControlsDisabled: Boolean;
 function FieldByName(const FieldName: String): TField;
 function FindField(const FieldName: String): TField;
 function GetBookmark: TBookmark;
 function IndexFieldCount:Integer;
 function IsEmpty: Boolean;
 function Locate(const KeyFields: string; const KeyValues: Variant; Options: TLocateOptions): Boolean;
 function Lookup(const KeyFields: string; const KeyValues: Variant; const ResultFields: string): Variant;
 function MoveBy(Distance: Integer): Integer;
 function RecordCount: Integer;
 procedure Append;
 procedure Cancel;
 procedure Close;
 procedure Delete;
 procedure DisableControls;
 procedure Edit;
 procedure EnableControls;
 procedure First;
 procedure FreeBookmark(Bookmark: TBookmark);
 procedure GetFieldList(List: TList; const FieldNames: String);
 procedure GetFieldNames(List: TStrings);
 procedure GotoBookmark(Bookmark: TBookmark);
 procedure Insert;
 procedure Last;
 procedure Next;
 procedure Open;
 procedure Post;
 procedure Prior;
 procedure Refresh;
end;

Pro připojení k ADO zdroji dat je třeba správně připravit ConnectionString. To je řetězec znaků obsahující jednotlivé parametry připojení oddělené středníky.

Parametr	Popis
Provider	jméno místního ADO providera, který se má využít pro komunikaci
Data Source	Jméno úložiště dat
File name	Jméno souboru obsahujícího informace o připojení
Remote Provider	Jméno ADO providera, který běží na vzdáleném počítači
Remote Server	Jméno vzdáleného serveru (v případe použití vzdáleného ADO providera)

Parametrů může být v závislosti na typu připojení i více.
Výsledný příkaz pro nastavení připojení k MS SQL serveru může vypadat např. takto:
t.ConnectionString:= 'Provider=SQLOLEDB.1;Password=heslo;Persist Security Info=True;User ID=sa;Initial Catalog=MojeDatabaze;Data Source=MujServer;Use Procedure for Prepare=1;Auto Translate=True;Packet Size=4096;Workstation ID=MujPC;Use Encryption for Data=False;Tag with column collation when possible=False';

nebo pro čtení dat z tabulky MS Excel:
t.ConnectionString:= 'Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Slozka\TestData.xls;Extended Properties=Excel 8.0'; Pro připojení k tabulce MS Excel musí být zpracovávaná data označena pomocí názvu (funkce Definovat název v MS Excel). Vlastnost Extended Properties určuje verzi MS Excel (např. Excel 8.0 označuje verzi MS Excel 97; Excel 9.0 označuje verzi MS Excel 2000)