Třída DataCollection
Tato třída je jednoduchou plochou kolekcí. Kolekce může obsahovat libovolný počet záznamů. Záznam si pamatuje hodnoty jako typ OleVariant. V některých málo případech kolekce podporují pojmenovaný přístup k hodnotám (ke každé hodnotě se také pamatuje její název). Názvy hodnot musí být unikátní v rámci kolekce, v opačném případě pak není možné k hodnotám přistupovat metodami skrze jejich jméno.
Metody a vlastnosti:
Add
procedure Add(Element: OleVariant);
- Popis:
- Přidá objekt do kolekce. Některé kolekce jsou určeny pouze ke čtení, např. kolekce objektů typu FieldDescription získaná metodou GetValueDescriptors, potom tato metoda nemá smysl.
Remove
procedure Remove(Index: Integer);
- Popis:
- Odstraní objekt z kolekce. Některé kolekce jsou určeny pouze ke čtení, např. kolekce objektů typu FieldDescription získaná metodou GetValueDescriptors, potom tato metoda nemá smysl.
Count
property Count: Integer readonly;
- Popis:
- Počet záznamů v kolekci.
Item
property Item[Index: Integer]: OleVariant readonly;
- Popis:
- Indexový přístup ke všem datům v kolekci. Hodnota Index musí nabývat hodnot od nuly do Count-1 včetně. Pokud hodnota Index je mimo povolený rozsah, je vyvolána výjimka.
_NewEnum
property _NewEnum: IUnknown readonly;
- Popis:
- Podpora pro konstrukci For Each.
ValueByName
property ValueByName[const Name: WideString]: OleVariant readonly;
- Popis:
- Vrátí hodnotu položky se jménem Name. Pokud kolekce tento přístup nepodporuje, je vyvolána výjimka.
FieldNames
property FieldNames[Index: Integer]: WideString readonly;
- Popis:
- Indexový přístup k názvům hodnot. Pokud kolekce tento přístup nepodporuje, je vyvolána výjimka.