VII. L'objet Catalog▲
C'est l'objet racine du modèle.
ActiveConnection (Prop. S)
C'est la seule propriété de l'objet Catalog, qui lui permet de définir le fournisseur de données, la base de données et éventuellement les paramètres de sécurité. Cette connexion est stricto sensu une connexion ADO, on peut donc parfaitement utiliser une connexion existante. Attention toutefois, ce sont les paramètres de la connexion qui définissent en partie les possibilités du fournisseur, il est donc vivement recommandé de créer sa connexion pour la gestion de la sécurité. Les deux codes suivants permettent de définir la connexion :
Dim
cnn1 As
New
ADODB.Connection
, Catalogue As
ADOX.
Set
Catalogue =
New
ADOX.Catalog
With
cnn1
.Provider
=
"Microsoft.Jet.OLEDB.4.0;"
.Properties
(
"Jet OLEDB:System database"
) =
"D:\User\jmarc\tutorial\ADOX\system.mdw"
.Open
"Data Source=D:\User\jmarc\tutorial\ADOX\baseheb.mdb ;User
Id=
Admin; Password=
"
End
With
Catalogue.ActiveConnection
=
cnn1
Ou
Catalogue.ActiveConnection
=
"Provider=Microsoft.Jet.OLEDB.4.0;"
&
"DataSource=:\User\jmarc\tutorial\ADOX\baseheb.mdb;Jet OLEDB:System database="
&
"D:\User\jmarc\tutorial\ADOX\system.mdw;User Id=Admin; Password="
Create (Mth.)
Permet la création d'une nouvelle base de données selon les paramètres de la chaîne de connexion passée en paramètre. Attention, le nom de la base de données ne doit pas être une base existante. Le paramètre à passer à la méthode doit être une chaîne de connexion valide.
GetObjectOwner et SetObjectOwner (Mth.)
De la forme
Catalog.SetObjectOwner
ObjectName, ObjectType , OwnerName [, ObjectTypeId]
Owner =
Catalog.GetObjectOwner
(
ObjectName, ObjectType [, ObjectTypeId])
Permet de renvoyer ou de définir le propriétaire d'un objet de la base, celui-ci pouvant être la base de données, une table, un champ…
Ne fonctionne qu'avec un fichier de sécurité défini.
Les collections
L'objet Catalog renvoie aussi cinq collections qui représentent la structure de la base. Nous allons maintenant étudier ces objets