------------------------------------------------------------------- Soubor README pro součást ADOX (Microsoft ActiveX(R) Data Objects Extensions for DLL and Security) ------------------------------------------------------------------- (c) 1998 Microsoft Corporation. Všechna práva vyhrazena. Tento dokument obsahuje nejnovější, dodatečné nebo později zjištěné informace, které doplňují dokumentaci součásti ADOX společnosti Microsoft. ----- OBSAH ----- 1. POPIS PRODUKTU 2. FUNKCE 3. TECHNICKÉ POZNÁMKY 4. ZNÁMÉ PROBLÉMY, OMEZENÍ A JEJICH ŘEŠENÍ ----------------- 1. POPIS PRODUKTU ----------------- Součást ADOX (Microsoft® ActiveX® Data Objects Extensions for Data Definition Language and Security) je rozšířením objektového a programovacího modelu ADO. Součást ADOX obsahuje objekty pro vytváření a úpravy schémat, včetně objektů pro nastavení zabezpečení. Vzhledem k tomu, že přístup ke schématům je zajištěn pomocí objektů, můžete vytvářet kód, který bude fungovat s různými zdroji dat bez ohledu na rozdíly v jejich nativní syntaxi. --------- 2. FUNKCE --------- Součást ADOX je doprovodná knihovna k základním objektům ADO. Zveřejňuje další objekty pro vytváření, úpravu a odstraňování objektů schémat, například tabulek a procedur. Knihovna také obsahuje objekty zabezpečení určené pro správu uživatelů a skupin a pro přidělení či odmítnutí přístupových práv k objektům. --------------------- 3. TECHNICKÉ POZNÁMKY --------------------- 3.1 Povinné a nepovinné vlastnosti objektů Table, Index a Column Zprostředkovatel dat nemusí podporovat všechny vlastnosti objektů Table, Index a Column. Pokud se pokusíte nastavit hodnotu vlastnosti, kterou zprostředkovatel nepodporuje, dojde k chybě. Pro nové objekty Table, Index a Column je chyba generována, jakmile objekt přidáte do kolekce. Pro stávající objekty se chyba vyskytne při nastavení vlastnosti. Existence příslušné výchozí hodnoty pro nepovinnou vlastnost při vytváření objektů Table, Index nebo Column nezaručuje, že zprostředkovatel vlastnost skutečně podporuje. Další informace o vlastnostech, které zprostředkovatel podporuje, najdete v dokumentaci k danému zprostředkovateli. 3.2 Použití součásti ADOX se zprostředkovateli Microsoft OLE DB Některé funkce součásti ADOX nejsou podporovány. Záleží na použitém zprostředkovateli OLE DB. Součást ADOX je plně podporována zprostředkovatelem Microsoft OLE DB for Microsoft Jet Database Engine. Informace o zprostředkovatelích Microsoft SQL Server OLE DB, Microsoft OLE DB for ODBC a Microsoft OLE DB for Oracle jsou uvedeny v dalším textu. Ostatní zprostředkovatelé Microsoft OLE DB součást ADOX nepodporují. Zprostředkovatel Microsoft SQL Server OLE DB Podporovány jsou veškeré objekty, kolekce, vlastnosti a metody součásti ADOX s výjimkou těch, které jsou uvedeny v následujícím seznamu: Objekt Catalog: metoda Create. Kolekce Tables: Vlastnosti existujících tabulek jsou určeny jen pro čtení (vlastnosti nových tabulek jsou určeny pro čtení i zápis). Kolekce Views: nejsou podporovány. Kolekce Procedures: metoda Append, metoda Delete, metoda Command. Kolekce Keys: metoda Append, metoda Delete. Kolekce Users: nejsou podporovány. Kolekce Groups: nejsou podporovány. Zprostředkovatel Microsoft OLE DB Provider for ODBC Podporovány jsou veškeré objekty, kolekce, vlastnosti a metody součásti ADOX s výjimkou těch, které jsou uvedeny v následujícím seznamu: Objekt Catalog: metoda Create. Kolekce Tables: metoda Append, metoda Delete. Vlastnosti existujících tabulek jsou určeny jen pro čtení (vlastnosti nových tabulek jsou určeny pro čtení i zápis). Kolekce Views: metoda Append, metoda Delete, vlastnost Command. Kolekce Procedures: metoda Append, metoda Delete, vlastnost Command. Kolekce Indexes: metoda Append, metoda Delete. Kolekce Keys: metoda Append, metoda Delete. Kolekce Users: nejsou podporovány. Kolekce Groups: nejsou podporovány. Zprostředkovatel Microsoft OLE DB for Oracle Podporovány jsou veškeré objekty, kolekce, vlastnosti a metody součásti ADOX s výjimkou těch, které jsou uvedeny v následujícím seznamu: Objekt Catalog: metoda Create. Kolekce Tables: metoda Append, metoda Delete. Vlastnosti existujících tabulek jsou určeny jen pro čtení (vlastnosti nových tabulek jsou určeny pro čtení i zápis). Kolekce Views: metoda Append, metoda Delete, metoda Command. Kolekce Procedures: metoda Append, metoda Delete, metoda Command. Kolekce Indexes: metoda Append, metoda Delete. Kolekce Keys: metoda Append, metoda Delete. Kolekce Users: nejsou podporovány. Kolekce Groups: nejsou podporovány. ------------------------------------------ 4. ZNÁMÉ PROBLÉMY, OMEZENÍ A JEJICH ŘEŠENÍ ------------------------------------------ Následuje seznam známých chyb součásti ADOX. 4.1 Vlastnosti DateCreated a DateModified vyžadují metodu Refresh Vlastnosti DateCreated a DateModified mají pro nově přidané objekty hodnotu NULL. Po přidání nového objektu View nebo Procedure proto musíte vyvolat metodu Refresh kolekce Views nebo Procedures. Teprve poté získáte hodnoty vlastností DateCreated a DateModified. 4.2 Vlastnost ParentCatalog není k dispozici pro objekty Index V nápovědě k součásti ADOX je vlastnost ParentCatalog nesprávně uvedena jako vlastnost objektů Index. Vlastnost ParentCatalog je ve skutečnosti pouze vlastností objektů Column a Table. 4.3 Konstanta adAccessRevoke potlačuje parametr Rights metody SetPermissions Při volání metody SetPermissions objektu Group nebo User způsobí nastavení parametru Actions na hodnotu adAccessRevoke potlačení parametru Rights. Pokud chcete uplatnit přístupová práva nastavená v parametru Rights, nenastavujte parametr Actions na konstantu adAccessRevoke. 4.4 Parametr RelatedColumn metody Append (kolekce Keys) Dokumentace metody Append kolekce Keys má zahrnovat nepovinný čtvrtý parametr RelatedColumn. Aktualizovaná syntaxe bude mít pak následující tvar: Keys.Append Key [, KeyType] [, Column] [, RelatedTable] [, RelatedColumn] Parametr RelatedColumn je nepovinný. Parametr RelatedColumn je hodnota typu String, která určuje název souvisejícího sloupce pro nevlastní klíč. Parametr RelatedTable může odpovídat hodnotě vlastnosti Name objektu Column. 4.5 Výčtová hodnota adIndexNullsAllow vlastnosti IndexNulls Dokumentace vlastnosti IndexNulls objektu Index má zahrnovat v tabulce platných výčtových hodnot jednu další konstantu: adIndexNullsAllow Index povoluje položky, jejichž klíčové sloupce mají hodnotu Null. Je-li v klíčovém sloupci zadána hodnota Null, položka je vložena do indexu.