Obiekt AdoRecordset (ADO Recordset)

Obiekt ADO Recordset przedstawia zestaw rekordów. Chodzi bezpośrednio o obiekt z implementacji technologii ADO od firmy Microsoft. W dokumentacji PROMOTIC są przedstawione tylko najważniejsze właściwości i metody. Dokładny opis interfejsu obiektu patrz http://msdn.microsoft.com/en-us/library/ms681510(v=VS.85).aspx lub http://www.w3schools.com/asp/ado_ref_recordset.asp.

Obiekt ADO Recordset: Obiekt AdoRecordset (zestaw rekordów) przedstawia dane rezultatu zapytania SQL. Dane składają się z dowolnej liczby rekordów, gdzie każdy rekord jednego obiektu AdoRecordset ma taką samą strukturę (obiekty AdoField). Dane mają więc charakter tablicy, gdzie wiersze odpowiadają rekordom a kolumny są tworzone obiektami AdoField.

Bieżący rekord: Jeden z rekordów można wybrać jako bieżący rekord. Chodzi o rekord, z którym można na bieżąco pracować. Cały szereg operacji dotyczy właśnie bieżącego rekordu. Do zmiany pozycji bieżącego rekordu po rekordach obiektu AdoRecordset służy całszereg metod, na przykład MoveFirst, MoveNext, itd. Bieżący rekord w obiekcie AdoRecordset może być najwyżej jeden, lecz nie musi być też żaden. Podczas przechodzenia rekordów jednego po drugim do przodu (do tyłu), przy przesuwaniu pozycji bieżącego rekordu o jeden do przodu przy pomocy metody MoveNext (do tyłu przy pomocy metody MovePrevious), w końcu bieżący rekord przesunie się za ostatni (lub przed pierwszy) rekord i przechodzenie rekordów tym samym jest zakończone. Do sprawdzenia, że bieżący rekord już nie jest ważny i przesunął się za ostatni rekord (lub przed pierwszy) służy właściwość EOF (BOF).

Obiekt ADO Record:
W zależności od konkretnego ADO Provider może się wydarzyć, że jednowierszowy wynik zapytania SQL nie zostanie zwrócony w formie obiektu AdoRecordset z jednym rekordem, lecz w postaci w formie obiektu AdoRecord (przedstawia jeden wiersz). Jednak zachowanie takie nie jest typowym dla najczęściej stosowanych ADO Provider. Obiekt AdoRecord jest zwracany raczej w przypadku jawnych operacji, kiedy z istniejącego obiektu AdoRecordset jest zwracany konkretny rekord w formie obiektu AdoRecord. Obiekt AdoRecord składa się z obiektów AdoField tak samo jak obiekt AdoRecordset, jedank w odróżnieniu od niego nie wspiera metody do zmiany pozycji bieżącego rekordu (np. MoveFirst).
W celu uproszczenia w dokumentacji PROMOTIC będziem przedstawiany powszechnie zwracany obiekt AdoRecordset, chociaż w okreĺonych pojedyńczych przypadkach może zostać zwracany także obiekt AdoRecord.