-------------------------------------------------------------------- Microsoft ActiveX(R) Data Objects Erweiterungen für DDL und Security Infodatei -------------------------------------------------------------------- (c) 1998 Microsoft Corporation. Alle Rechte vorbehalten. In diesem Dokument finden Sie aktuelle und andere Informationen, die die Dokumentation von Microsoft ADO Erweiterungen für DDL und Security (ADOX) ergänzen. ------ INHALT ------ 1. PRODUKTBESCHREIBUNG 2. FEATURES 3. TECHNISCHE HINWEISE 4. BEKANNTE FEHLER UND EINSCHRÄNKUNGEN UND WIE SIE UMGANGEN WERDEN KÖNNEN ---------------------- 1. PRODUKTBESCHREIBUNG ---------------------- Bei Microsoft(r) ActiveX(r) Data Objects Extensions for Data Definition Language and Security (ADOX) handelt es sich um eine Erweiterung der ADO-Objekte und des ADO-Programmiermodells. In ADOX sind Objekte zur Erstellung und Veränderung von Schemata sowie für die Sicherheit enthalten. Da es sich hierbei um einen objektbasierten Ansatz der Schemabearbeitung handelt, ist es möglich, Code zu schreiben, der mit verschiedenen Datenquellen arbeiten kann, ohne Berücksichtigung der Unterschiede ihrer jeweiligen Syntax. ----------- 2. FEATURES ----------- ADOX ist eine Bibliothek, die die zentralen ADO-Objekte begleitet. Es basiert auf zusätzlichen Objekten zum Erstellen, Verändern und Löschen von Schemaobjekten wie z.B. Tabellen und Prozeduren. Außerdem enthält es Sicherheitsobjekte zum Verwalten von Benutzern und Gruppen sowie zum Erteilen und Widerrufen von Berechtigungen für Objekte. ---------------------- 3. TECHNISCHE HINWEISE ---------------------- 3.1 Erforderliche/Optionale Eigenschaften von Tabellen, Indizes und Spalten Möglicherweise unterstützt Ihr Datenprovider nicht alle Eigenschaften von Table-, Index- und Column-Objekten. Wenn Sie einen Wert für eine Eigenschaft festgelegt haben, die von dem Provider nicht unterstützt wird, tritt ein Fehler auf. Bei neuen Table-, Index- oder Column-Objekten tritt der Fehler auf, wenn das Objekt an die Auflistung angehängt wird. Bei bereits bestehenden Objekten tritt der Fehler beim Festlegen der Eigenschaft auf. Beim Erstellen von Table-, Index- oder Column-Objekten ist das Vorhandensein eines entsprechenden Standardwerts für eine optionale Eigenschaft keine Gewährleistung dafür, dass die Eigenschaft von Ihrem Provider unterstützt wird. Weitere Informationen darüber, welche Eigenschaften von Ihrem Provider unterstützt werden, finden Sie in der Dokumentation Ihres Providers. 3.2 Verwenden von ADOX mit Microsoft OLE DB-Providern Bestimmte Features von ADOX werden je nach Ihrem OLE DB-Datenprovider nicht unterstützt. ADOX wird bei dem Microsoft OLE DB-Provider für das Microsoft Jet-Datenbankmodul voll unterstützt. Weitere Informationen zum Microsoft SQL Server OLE DB-Provider, dem Microsoft OLE DB-Provider für ODBC und dem Microsoft OLE DB-Provider für Oracle finden Sie weiter unten. ADOX wird von keinem anderen Microsoft OLE DB-Provider unterstützt. Microsoft SQL Server OLE DB-Provider Alle ADOX-Objekte, -Auflistungen, -Eigenschaften und -Methoden mit Ausnahme der hier aufgeführten werden unterstützt: Catalog: Create-Methode. Tables: Eigenschaften für bereits bestehende Tabellen sind schreibgeschützt (Eigenschaften für neue Tabellen können gelesen oder geschrieben werden) Views: Wird nicht unterstützt. Procedures: Append-Methode, Delete-Methode, Command-Eigenschaft. Keys: Append-Methode, Delete-Methode. Users: Wird nicht unterstützt. Groups: Wird nicht unterstützt. Microsoft OLE DB-Provider für ODBC Alle ADOX-Objekte, -Auflistungen, -Eigenschaften und -Methoden mit Ausnahme der hier aufgeführten werden unterstützt: Catalog: Create-Methode. Tables: Append-Methode, Delete-Methode. Eigenschaften für bereits bestehende Tabellen sind schreibgeschützt (Eigenschaften für neue Tabellen können gelesen oder geschrieben werden) Views: Append-Methode, Delete-Methode, Command-Eigenschaft. Procedures: Append-Methode, Delete-Methode, Command-Eigenschaft. Indexes: Append-Methode, Delete-Methode. Keys: Append-Methode, Delete-Methode. Users: Wird nicht unterstützt. Groups: Wird nicht unterstützt. Microsoft OLE DB-Provider für Oracle Alle ADOX-Objekte, -Auflistungen, -Eigenschaften und -Methoden mit Ausnahme der hier aufgeführten werden unterstützt: Catalog: Create-Methode. Tables: Append-Methode, Delete-Methode. Eigenschaften für bereits bestehende Tabellen sind schreibgeschützt (Eigenschaften für neue Tabellen können gelesen oder geschrieben werden) Views: Append-Methode, Delete-Methode, Command-Eigenschaft. Procedures: Append-Methode, Delete-Methode, Command-Eigenschaft. Indexes: Append-Methode, Delete-Methode. Keys: Append-Methode, Delete-Methode. Users: Wird nicht unterstützt. Groups: Wird nicht unterstützt. ------------------------------------------------------------------------- 4. BEKANNTE FEHLER UND EINSCHRÄNKUNGEN UND WIE SIE UMGANGEN WERDEN KÖNNEN ------------------------------------------------------------------------- Im Folgenden finden Sie eine Liste der bekannten Fehler von ADOX. 4.1 Eigenschaften DateCreated/DateModified erfordern Refresh Die Eigenschaften DateCreated und DateModified sind für neu angehängte Objekte NULL. Nach dem Anhängen eines neuen View- oder Procedure-Objekts müssen Sie die Refresh-Methode der Views- oder Procedures-Auflistung aufrufen, um Werte für die DateCreated- und DateModified-Eigenschaft zu erhalten. 4.2 Keine ParentCatalog-Eigenschaft für Index-Objekte In der Hilfe zu ADOX wird ParentCatalog irrtümlich als Eigenschaft von Index-Objekten aufgeführt. Tatsächlich ist ParentCatalog jedoch nur eine Eigenschaft von Column- und Table-Objekten. 4.3 adAccessRevoke überschreibt den Rights-Parameter von SetPermissions Beim Aufrufen der SetPermissions-Methode eines Group- oder User-Objekts führt das Festlegen des Actions-Parameters auf adAccessRevoke dazu, dass alle Einstellungen des Rights-Parameters überschrieben werden. Legen Sie Actions nicht auf adAccessRevoke fest, wenn die Rechte, die im Rights-Parameter angegeben sind, wirksam werden sollen. 4.4 RelatedColumn-Parameter der Append-Methode (Keys-Auflistung) In der Dokumentation für die Append-Methode der Keys-Auflistung fehlt der optionale vierte Parameter RelatedColumn. Die aktualisierte Syntax lautet folgendermaßen: Keys.Append Key [, KeyType] [, Column] [, RelatedTable] [, RelatedColumn] Der RelatedColumn-Parameter ist optional. RelatedColumn ist ein Zeichenfolge, die den Namen der entsprechenden Spalte für einen Fremdschlüssel bezeichnet. Der RelatedTable-Parameter kann dem Wert der Name-Eigenschaft eines Column-Objekts entsprechen. 4.5 Enum-Parameter für adIndexNullsAllow der IndexNulls-Eigenschaft In der Dokumentation für die IndexNulls-Eigenschaft des Index-Objekts fehlt die Enum-Konstante in der Tabelle der gültigen Werte: adIndexNullsAllow Der Index erlaubt Einträge, wenn die Schlüsselspalten den Wert Null haben. Wenn in eine Schlüsselspalte ein Nullwert eingegeben wird, wird dieser Eintrag in den Index eingefügt.