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 do ADO correspondem a objetos que você vê no banco de dados, por exemplo, um objeto Table corresponde a uma tabela do 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 do Access e são definidas da mesma forma em qualquer aplicativo que inclua o mecanismo de banco de dados do Access. Algumas propriedades que você pode definir para objetos do ADO são definidas pelo Access e não são reconhecidas automaticamente pelo mecanismo de banco de dados do Access. A maneira como você define propriedades para objetos ADO depende se uma propriedade é definida pelo mecanismo de banco de dados do Access ou pelo Access.

Definir propriedades do ADO para objetos do 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 do Access para objetos ADO

Quando você define uma propriedade definida pelo Access, mas que se aplica a um objeto ADO, 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. Depois que a propriedade estiver na coleção Properties , ela poderá 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 um 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.

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

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.