Definir as propriedades de ActiveX Data Objects no Visual Basic

O ActiveX Data Objects (ADO) permite manipular a estrutura do banco de dados e os dados que ele contém usando o Visual Basic. Muitos objetos ADO correspondem a objetos que você vê em seu banco de dados, por exemplo, um objeto Table corresponde a uma tabela access. Um objeto Field corresponde a um campo em uma tabela.

A maior parte das propriedades que podem ser definidas para objetos ADO são propriedades ADO. Essas propriedades são definidas pelo mecanismo de banco de dados access e são definidas da mesma maneira em qualquer aplicativo que inclua o mecanismo de banco de dados access. Algumas propriedades que você pode definir para objetos ADO são definidas pelo Access e não são reconhecidas automaticamente pelo mecanismo de banco de dados access. A forma como você define propriedades para objetos ADO depende se uma propriedade é definida pelo mecanismo de banco de dados access ou pelo Access.

Definir propriedades do ADO para objetos ADO

Para configurar uma propriedade definida pelo mecanismo de banco de dados do Access, refira-se ao objeto na hierarquia ADO. A maneira mais fácil e rápida de fazer isso é criar variáveis de objeto que representem os diferentes objetos dos quais você precisa para trabalhar e refira-se às variáveis de objeto nas etapas subsequentes do código. Por exemplo, o código a seguir cria um novo objeto TableDef e define sua propriedade Name:

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

Definir propriedades de acesso para objetos ADO

Quando você define uma propriedade definida pelo Access, mas se aplica a um objeto ADO, o mecanismo de banco de dados 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. Depois que a propriedade estiver na coleção Propriedades , ela pode ser definida da mesma maneira que qualquer propriedade ADO.

Se a propriedade for definida pela primeira vez na interface do usuário, ela será automaticamente acrescentada à coleção Properties e você poderá defini-la normalmente.

Ao escrever procedimentos para definir propriedades definidas pelo Access, você deve incluir o código de tratamento de erros para verificar se a propriedade que você está definindo já existe na coleção Propriedades .

Lembre-se de que ao criar uma propriedade, é preciso especificar corretamente a sua propriedade Type antes de anexá-la à coleção Properties. 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 sequência	adLongVarWChar ou adVarWChar
Verdade / False	adBoolean
Um inteiro	adInteger

A tabela a seguir lista algumas propriedades definidas pelo Access que se aplicam a objetos ADO.

Objeto ADO	Propriedades definidas pelo Microsoft Access
Connection	AppTitle, AppIcon, StartupShowDBWindow, StartupShowStatusBar, AllowShortcutMenus, AllowFullMenus, AllowBuiltInToolbars, AllowToolbarChanges, AllowBreakIntoCode, AllowSpecialKeys, Replicable, ReplicationConflictFunction
Table	DatasheetBackColor, DatasheetCellsEffect, DatasheetFontHeight, DatasheetFontItalic, DatasheetFontName, DatasheetFontUnderline, DatasheetFontWeight, DatasheetForeColor, DatasheetGridlinesBehavior, DatasheetGridlinesColor, Description, FrozenColumns, RowHeight, ShowGrid
Campo	Caption, ColumnHidden, ColumnOrder, ColumnWidth, DecimalPlaces, Description, Format, InputMask

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.