Trieda Rowset

Inštancie triedy Rowset umožňujú programátorovi prístup k záznamom získaným vyhľadávaním v databáze pomocou DynSQL. Inštancie sa získavajú vyvolaním metódy DynamicQuery.Rowsets alebo DynamicQuery.RowsetByName. Je nutné uvedomiť si, že rowset prechádzajú dátami jednopriechodovo (nie je možné vracať sa, je možné len načítať ďalšie a ďalšie záznamy). Pozor, všetky nastavenia vlastností je nutné nastaviť pred vyvolaním metódy DynamicQuery.Execute(). Po vyvolaní tejto metódy je už možné používať rowset len na prechádzanie a čítanie záznamov.

Metódy a vlastnosti:

property Fields[Index: Integer]: ResultFieldDescription readonly;
Popis:
Indexový prístup k všetkým stĺpcom definovaným v tomto rowsete. Parameter Index musí nadobúdať platné hodnoty od nuly do FieldCount-1 vrátane. Pokiaľ je hodnota v parametri Index platná, je vrátená inštancia objektu ResultFieldDescription, pokiaľ je hodnota neplatná, je vyvolaná výnimka.
Súvisiace metódy:
FieldCount, FieldByName
property FieldCount: Integer readonly;
Popis:
Počet všetkých stĺpcov v tomto rowsete.
Súvisiace metódy:
Fields, FieldByName
function FieldByName(const AName: WideString): ResultFieldDescription;
Popis:
Prístup k stĺpcom cez meno stĺpca. Pokiaľ stĺpec s názvom AName existuje, bude vrátený objekt ResultFieldDescription, inak je vyvolaná výnimka.
Súvisiace metódy:
Fields, FieldCount
function FindField(const AName: WideString): ResultFieldDescription;
Popis:
Otázka na existujúce radenie. Pokiaľ žiadne neexistuje, funkcia vráti NULL.
Súvisiace metódy:
Fields, FieldByName.
property Used: WordBool;
Popis:
Každé DynSQL môže definovať viac ako jeden rowset (dataset). Takmer vo všetkých prípadoch nechceme získavať dáta zo všetkých týchto rowsetov, pretože to zvyšuje počet požiadaviek a následne spomaľuje prechádzanie datasetmi. Pokiaľ je hodnota nastavená na False, rowset nebude otvorený a nebude ho možné použiť na prechádzanie a získavanie záznamov. Pokiaľ rowset potrebujete, musíte nastaviť Used = True a musíte špecifikovať aspoň jeden stĺpec do vlastnosti UsedFields. Základná hodnota je False. Pozor, rowset s názvom "MAIN" musí byť vždy Used = True.
Súvisiace metódy:
UsedFields 
property UsedFields: WideString;
Popis:
Pridaním názvov stĺpcov do tejto property si určíte, aké stĺpce si želáte. Nastavenie tejto vlastnosti je trochu zvláštne, reťazec musí obsahovať názvy stĺpcov (napr. získaných z Fields) oddelených znakmi CRLF (#13#10). Nastavením hodnoty sa tiež mení vlastnosť Used. Pokiaľ zadáte prázdny reťazec, rowset sa vypne (pozor na rowset "MAIN"). Pokiaľ zadáte aspoň názov jedného stĺpca, tak sa nastaví Used na True.
Súvisiace metódy:
Used 
property Name: WideString readonly;
Popis:
Názov tohto rowsetu získaný z DynSQL.
property EOF: WordBool readonly;
Popis:
EOF hovorí, či je ešte možné získať ďalšiu vetu. Pokiaľ sa hodnota EOF rovná True, ste na konci rowsetu a nie je možné prečítať ďalšiu vetu vyvolaním funkcie Next(). Pokiaľ rowset nie je pripravený čítať dáta (napr. Used je False, alebo nebolo volané DynamicQuery.Execute()), je vyvolaná výnimka.
Súvisiace metódy:
Next 
procedure Next;
Popis:
Vyvolaním metódy povieme, že si želáme načítať ďalšiu vetu. Pokiaľ rowset nie je pripravený čítať dáta, je vyvolaná výnimka. Pred vyvolaním je dobré si overiť, či je ešte možné čítať vyvolaním EOF().
Súvisiace metódy:
EOF 
property Data: DataCollection readonly;
Popis:
Táto vlastnosť sprístupňuje jednotlivé hodnoty aktuálneho riadka v rowsete. Vrátený objekt je kolekcia. Aké stĺpce a hodnoty bude možné z kolekcie získať, je závislé na nastavení vlastnosti UsedFields.