Objekt
ADO Recordset představuje množinu záznamů. Jedná se přímo o objekt z implementace technologie
ADO od firmy
Microsoft. V dokumentaci PROMOTIC budou uvedeny jenom nejdůležitější vlastnosti a metody. Přesný popis rozhraní objektu viz
http://msdn.microsoft.com/en-us/library/ms681510(v=VS.85).aspx nebo
http://www.w3schools.com/asp/ado_ref_recordset.asp.
Objekt ADO Recordset: Objekt
AdoRecordset (množina záznamů) představuje výsledná data
SQL dotazu. Data se skladají z libovolného množství záznamů, kde každý záznam jednoho objektu
AdoRecordset má stejnou strukturu (objekty
AdoField). Data mají tedy tabulkovou podobu, kde řádky odpovídají záznamům a sloupce jsou tvořeny objekty
AdoField.
Aktuální záznam: Jeden ze záznamů lze vybrat jako aktuální záznam. Jedná se o záznam, se kterým se právě pracuje. Celá řada operací se týká aktuálního záznamu. K pohybu pozice aktuálního záznamu po záznamech objektu
AdoRecordset slouží mnoho metod, například
MoveFirst,
MoveNext, atd. Aktuální záznam v objektu
AdoRecordset může být maximálně jeden, ale nemusí také být žádný. Při procházení záznamů jednoho po druhém dopředu (dozadu), s posouváním pozice aktuálního záznamu o jeden dopředu metodou
MoveNext (dozadu metodou
MovePrevious), se nakonec aktuální záznam dostane až za poslední (první) záznam a procházení záznamů tím končí. K indikaci toho, že aktuální záznam už není platný a dostal se za poslední záznam (nebo před první), slouží vlastnost
EOF (
BOF).
Objekt ADO Record:
V závislosti na konkrétním
ADO Provider se může stát, že jednořádkový výsledek
SQL dotazu nebude vrácen v podobě objektu
AdoRecordset s jedním záznamem, ale v podobě objektu
AdoRecord (představuje jeden řádek). Není to ale typické pro nejběžněji užívané
ADO Provider. Objekt
AdoRecord je spíše vrácen při explicitních operacích, kdy z existujícího objektu
AdoRecordset se vrátí konkrétní záznam v podobě objektu
AdoRecord. Objekt
AdoRecord se skládá z objektů
AdoField stejně jako objekt
AdoRecordset, na rozdíl od něj však nepodporuje metody pro přesun pozice aktuálního záznamu (např.
MoveFirst).
V dokumentaci PROMOTIC se pro zjednodušení bude uvádět pouze běžnější vracený objekt
AdoRecordset, přestože v určitých ojedinělých případech může být vrácen i objekt
AdoRecord.