Container object (DAO)

S’applique à : Access 2013, Office 2013

Un objet Container regroupe des types d'objets Document similaires.

Remarques

Chaque objet Database possède une collection Containers composée d’objets Container intégrés. Les applications peuvent définir leurs propres types de documents et conteneurs correspondants (bases de données du moteur de base de données Microsoft Access uniquement) ; Toutefois, ces objets peuvent ne pas toujours être pris en charge par le biais de DAO.

Certains de ces objets Container sont définis par le moteur de base de données Microsoft Access alors que les autres peuvent définis par d'autres applications. Le tableau ci-dessous répertorie le nom de chaque objet Container défini par le moteur de base de données Microsoft Access et indique le type d'informations qu'ils contiennent.

Nom du conteneur	Contient des informations sur
Bases de données	Bases de données enregistrées
Tableaux	Tables et requêtes enregistrées
Relations	Relations enregistrées

Remarque

[!REMARQUE] Ne confondez pas les objets Container répertoriés dans le tableau précédent avec les collections du même nom. L'objet Container des bases de données renvoie à tous les objets de base de données enregistrés, mais la collection Databases renvoie uniquement aux objets de base de données ouverts dans un espace de travail déterminé.

Chaque objet Container comporte une collection Documents qui contient des objets Document qui décrivent les instances des objets intégrés du type spécifié par l'objet Container. Généralement, vous utilisez un objet Container comme liaison intermédiaire vers les informations dans l'objet Document. Vous pouvez également utiliser la collection Containers pour définir la sécurité de tous les objets Document d'un type déterminé.

Avec un objet Container existant, vous pouvez :

• Utiliser la propriété Name pour renvoyer le nom prédéfini de l'objet Container.

• Utiliser la propriété Owner pour définir ou renvoyer le propriétaire de l'objet Container. Pour définir la propriété Owner, vous devez disposer de l'autorisation d'écrire pour l'objet Container, et vous devez définir la propriété sur le nom d'un objet User ou Group existant.

• Utiliser les propriétés Permissions et UserName pour définir les autorisations d'accès pour l'objet Container. Tout objet Document créé dans la collection Documents d'un objet Container hérite de ces paramètres d'autorisation d'accès.

Comme les objets Container sont intégrés, vous ne pouvez pas créer d'objets Container ou supprimer des objets Container existants.

Pour renvoyer à un objet Container dans une collection par son numéro ordinal ou par son paramètre de propriété Name, utilisez l'une des formes de syntaxe suivantes :

• Conteneurs(0)

• Containers(« name »)

• Conteneurs ! [name]

Exemple

Cet exemple énumère la collection Containers de la base de données Northwind et la collection Properties de chaque objet Container dans la collection.

    Sub ContainerObjectX() 
     
     Dim dbsNorthwind As Database 
     Dim ctrLoop As Container 
     Dim prpLoop As Property 
     
     Set dbsNorthwind = OpenDatabase("Northwind.mdb") 
     
     With dbsNorthwind 
     
     ' Enumerate Containers collection. 
     For Each ctrLoop In .Containers 
     Debug.Print "Properties of " & ctrLoop.Name _ 
     & " container" 
     
     ' Enumerate Properties collection of each 
     ' Container object. 
     For Each prpLoop In ctrLoop.Properties 
     Debug.Print " " & prpLoop.Name _ 
     & " = " prpLoop 
     Next prpLoop 
     
     Next ctrLoop 
     
     .Close 
     End With 
     
    End Sub