Objeto container (DAO)

Aplica-se ao: Access 2013, Office 2013

Um objeto Container agrupa tipos semelhantes de objetos Document.

Comentários

Cada objeto Database tem uma coleção Containers que consiste em objetos Container incorporados. Os aplicativos podem definir seus próprios tipos de documentos e contêineres correspondentes (apenas bancos de dados do mecanismo de banco de dados do Microsoft Access); entretanto, esses objetos nem sempre são aceitos no DAO.

Alguns desses objetos Container são definidos pelo mecanismo de banco de dados do Microsoft Access enquanto outros podem ser definidos por outros aplicativos. A tabela a seguir lista o nome de cada objeto Container definido pelo mecanismo de banco de dados do Microsoft Access e o tipo de informações que ele contém.

Nome do contêiner	Contém informações sobre
Bancos de dados	Bancos de dados salvos
Tabelas	Tabelas e consultas salvas
Relations	Relações salvas

Observação

[!OBSERVAçãO] Não confunda os objetos Container listados na tabela anterior com as coleções de mesmo nome. O objeto Container do banco de dados se refere a todos os objetos salvos do banco de dados, mas a coleção Databases se refere apenas aos objetos do banco de dados que estão abertos em um determinado espaço de trabalho.

Cada objeto Container tem uma coleção Documents que contém objetos Document que descrevem instâncias de objetos incorporados do tipo especificado pelo Container. Você normalmente usa um objeto Container como um link intermediário para as informações no objeto Document. Você também pode usar a coleção Containers para definir segurança em todos os objetos Document de um determinado tipo.

Com um objeto Container existente, você pode:

• Usar a propriedade Name para retornar o nome predefinido do objeto Container.

• Usar a propriedade Owner para definir ou retornar o proprietário do objeto Container. Para definir a propriedade Owner, você deve ter permissão de gravação no objeto Container e definir a propriedade para o nome de um objeto User ou Group existente.

• Usar as propriedades Permissions e UserName para definir as permissões de acesso para o objeto Container; qualquer objeto Document criado na coleção Documents de um objeto Container herda essas configurações de permissão de acesso.

Como os objetos Container são incorporados, você não pode criar novos objetos Container nem excluir os existentes.

Para referir-se a um objeto Container de uma coleção pelo número ordinal ou pela configuração da propriedade Name, use qualquer uma das formas de sintaxe a seguir:

• Contêineres(0)

• Contêineres("nome")

• Contêineres! [nome]

Exemplo

Este exemplo enumera a coleção Containers do banco de dados Northwind e a coleção Properties de cada objeto Container na coleção.

    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