Définir les propriétés d’ActiveX Data Objects dans Visual Basic

ActiveX Data Objects (ADO) enable you to manipulate the structure of your database and the data it contains from Visual Basic. De nombreux objets ADO correspondent à des objets que vous voyez dans votre base de données, par exemple, un objet Table correspond à une table Access. Un objet Field correspond au champ d'une table.

La plupart des propriétés que vous définissez dans les objets ADO sont des propriétés ADO. Ces propriétés sont définies par le moteur de base de données Access et sont définies de la même façon dans toute application qui inclut le moteur de base de données Access. Certaines propriétés que vous pouvez définir pour les objets ADO sont définies par Access et ne sont pas automatiquement reconnues par le moteur de base de données Access. La façon dont vous définissez les propriétés des objets ADO varie selon qu’une propriété est définie par le moteur de base de données Access ou par Access.

Définir les propriétés ADO pour les objets ADO

Pour paramétrer une propriété définie par le moteur de base de données Access, faites référence à l'objet dans la hiérarchie des objets ADO. La manière la plus facile et la plus rapide d'y parvenir est de créer des variables de type objet représentant les différents objets que vous devez manipuler, et de faire ultérieurement référence aux variables de type objet dans votre code. Par exemple, le code suivant crée un nouvel objet TableDef et définit sa propriété Name:

Dim tbl As New ADOX.Table 
Dim cnn As ADODB.Connection 
Set cnn = CurrentProject.Connection 
tbl.Name = "Contacts"

Définir les propriétés Access pour les objets ADO

Lorsque vous définissez une propriété définie par Access, mais qui s’applique à un objet ADO, le moteur de base de données Access ne reconnaît pas automatiquement la propriété comme une propriété valide. La première fois que vous définissez la propriété, vous devez la créer et l'ajouter à la collection Properties de l'objet auquel elle s'applique. Une fois que la propriété se trouve dans la collection Properties , elle peut être définie de la même manière que n’importe quelle propriété ADO.

Si la propriété est définie pour la première fois dans l'interface utilisateur, elle est automatiquement ajoutée à la collection Properties et vous pouvez la définir normalement.

Lorsque vous écrivez des procédures pour définir des propriétés définies par Access, vous devez inclure du code de gestion des erreurs pour vérifier que la propriété que vous définissez existe déjà dans la collection Properties .

Gardez à l'esprit que lorsque vous créez la propriété, vous devez spécifier correctement sa propriété Type avant de l'ajouter à la collection Properties. Vous pouvez déterminer la propriété Type en fonction des informations de la section Paramètres de la rubrique d'aide pour la propriété individuelle. Le tableau suivant présente quelques conseils pour déterminer le paramétrage de la propriété Type.

Si le paramètre de la propriété est	Le paramètre de la propriété Type doit être
Une chaîne de caractères	adLongVarWChar ou adVarWChar
Vrai / Faux	adBoolean
Un entier	adInteger

Le tableau suivant répertorie certaines propriétés définies par Access qui s’appliquent aux objets ADO.

Objet ADO	Propriétés définies par Microsoft Access
Connection	AppTitle, AppIcon, StartupShowDBWindow, StartupShowStatusBar, AllowShortcutMenus, AllowFullMenus, AllowBuiltInToolbars, AllowToolbarChanges, AllowBreakIntoCode, AllowSpecialKeys, Replicable, ReplicationConflictFunction
Tableau	DatasheetBackColor, DatasheetCellsEffect, DatasheetFontHeight, DatasheetFontItalic, DatasheetFontName, DatasheetFontUnderline, DatasheetFontWeight, DatasheetForeColor, DatasheetGridlinesBehavior, DatasheetGridlinesColor, Description, FrozenColumns, RowHeight, ShowGrid
Field	Caption, ColumnHidden, ColumnOrder, ColumnWidth, DecimalPlaces, Description, Format, InputMask

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.