Definir propriedades de Objetos de Acesso a Dados no Visual Basic
Aplica-se ao: Access 2013 | Access 2016
Os Data Access Objects (DAO) permitem que você manipule a estrutura do seu banco de dados e os dados nele contidos a partir do Visual Basic. Vários objetos do DAO correspondem aos objetos vistos no banco de dados; por exemplo, um objeto TableDef corresponde a uma tabela do Microsoft Access. Um objeto Field corresponde a um campo em uma tabela.
A maior parte das propriedades que você define para objetos DAO são propriedades DAO. Essas propriedades são definidas pelo mecanismo de banco de dados Microsoft Access da mesma forma que em qualquer aplicativo que inclua o mecanismo de banco de dados do Access. Algumas propriedades definidas para objetos DAO são definidas pelo Microsoft Access e não são reconhecidas automaticamente pelo mecanismo de banco de dados do Access. O modo de definição das propriedades de objetos DAO depende da propriedade ser definida pelo mecanismo de banco de dados do Access ou pelo Microsoft Access.
Definir propriedades DAO para objetos DAO
Para configurar uma propriedade que seja definida pelo mecanismo de banco de dados do Access, refira-se ao objeto na hierarquia DAO. A maneira mais fácil e rápida de se fazer isso é a criação de variáveis de objeto que representem os diferentes objetos necessários para trabalhar e se referir às variáveis de objeto em etapas subsequentes do seu código. Por exemplo, o código a seguir cria um novo objeto TableDef e define sua propriedade Name:
Dim dbs As DAO.Database
Dim tdf As DAO.TableDef
Set dbs = CurrentDb
Set tdf = dbs.CreateTableDef
tdf.Name = "Contacts"
Definir propriedades do Microsoft Access para objetos DAO
Quando você configura uma propriedade definida pelo Microsoft Access, mas que se aplica a um objeto DAO, o mecanismo de banco de dados do Access não reconhece automaticamente a propriedade como uma propriedade válida. Na primeira vez em que a propriedade for definida, crie a propriedade e acrescente-a à coleção Properties do objeto ao qual ela se aplica. Assim que a propriedade estiver na coleção Properties, poderá ser definida da mesma forma que qualquer propriedade DAO.
If the property is set for the first time in the user interface, it's automatically added to the Properties collection, and you can set it normally.
When writing procedures to set properties defined by Microsoft Access, you should include error-handling code to verify that the property you are setting already exists in the Properties collection. See the Help topic about the CreateProperty method or the individual property topic for more information.
Keep in mind that when you create the property, you must correctly specify its Type property before you append it to the Properties collection. Você pode determinar a propriedade Type com base nas informações da seção Definições do tópico da Ajuda sobre a propriedade individual. A tabela a seguir oferece algumas diretrizes para a determinação da definição da propriedade Type.
| Se a configuração da propriedade for | A configuração da propriedade Type deve ser |
|---|---|
| Uma cadeia de caracteres | dbText |
| Verdade / False | dbBoolean |
| Um inteiro | dbInteger |
The following table lists some Microsoft Access-defined properties that apply to DAO objects.
| Objeto DAO | Propriedades definidas pelo Microsoft Access |
|---|---|
| Banco de dados | AppTitle, AppIcon, StartupShowDBWindow, StartupShowStatusBar, AllowShortcutMenus, AllowFullMenus, AllowBuiltInToolbars, AllowToolbarChanges, AllowBreakIntoCode, AllowSpecialKeys, Replicable, ReplicationConflictFunction |
| Container SummaryInfo | Title, Subject, Author, Manager, Company, Category, Keywords, Comments, Hyperlink Base (Consulte a guia Resumo da caixa de diálogo Propriedades DatabaseName, disponível selecionando Propriedades do Banco de Dados no menu Arquivo.) |
| Container UserDefined | (Confira a guia Resumo da caixa de diálogo Propriedades do DatabaseName, disponível selecionando Propriedades do Banco de Dados no menu Arquivo.) |
| TableDef | DatasheetBackColor, DatasheetCellsEffect, DatasheetFontHeight, DatasheetFontItalic, DatasheetFontName, DatasheetFontUnderline, DatasheetFontWeight, DatasheetForeColor, DatasheetGridlinesBehavior, DatasheetGridlinesColor, Description, FrozenColumns, RowHeight, ShowGrid |
| QueryDef | DatasheetBackColor, DatasheetCellsEffect, DatasheetFontHeight, DatasheetFontItalic, DatasheetFontName, DatasheetFontUnderline, DatasheetFontWeight, DatasheetForeColor, DatasheetGridlinesBehavior, DatasheetGridlinesColor, Description, FailOnError, FrozenColumns, LogMessages, MaxRecords, RecordLocks, RowHeight, ShowGrid, UseTransaction |
| Campo | Caption, ColumnHidden, ColumnOrder, ColumnWidth, DecimalPlaces, Description, Format, InputMask |
Confira também
- Fórum do Access para desenvolvedores
- Ajuda do Access em support.office.com
- Fóruns do Access no UtterAccess
- Central de ajuda da programação VBA e desenvolvedor do Access (FMS)
- Postagens do Access no StackOverflow
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.