Método DBEngine.OpenConnection (DAO)

Aplica-se ao: Access 2013, Office 2013

Sintaxe

expressão . OpenConnection(Nome, Opções, ReadOnly, Ligar)

expressão Uma variável que representa um objeto DBEngine.

Parâmetros

Nome

Necessária/opcional

Tipo de dados

Descrição

Name

Obrigatório

String

Uma expressão de cadeia de caracteres Consulte a discussão em Comentários.

Opções

Opcional

Variant

Define as várias opções para a conexão, como especificado em Comentários. Com base nessa valor, o gerenciador do driver ODBC solicita ao usuário informações de conexão, como o DSN (Nome da fonte de dados), o nome do usuário e a senha.

ReadOnly

Opcional

Variant

True se a conexão tiver que ser aberta para acesso somente leitura, e False se a conexão tiver que ser aberta para acesso de leitura/gravação (padrão).

Connect

Opcional

Variant

Uma cadeia de caracteres de conexão ODBC. Veja a propriedade Ligar para obter os elementos específicos e a sintaxe desta cadeia. É necessário incluir antes "ODBC;".

Valor de retorno

Conexão

Comentários

Use o método OpenConnection para estabelecer uma conexão com uma fonte de dados ODBC a partir de um espaço de trabalho ODBCDirect. O método OpenConnection é semelhante mas não igual a OpenDatabase. A principal diferença é que OpenConnection está disponível em um espaço de trabalho ODBCDirect.

Se especificar um nome de origem de dados (DSN) ODBC registado no argumento connect, o argumento name pode ser qualquer cadeia válida e também fornecerá a propriedade Nome para o objeto Ligação . Se um DSN válido não estiver incluído no argumento ligar, o nome tem de fazer referência a um DSN ODBC válido, que também será a propriedade Nome . Se nem o nome nem a ligação contiverem um DSN válido, o gestor de controladores ODBC pode ser definido (através do argumento de opções) para pedir ao utilizador as informações de ligação necessárias. O DSN é fornecido pela solicitação e depois fornece a propriedade Name.

O argumento de opções determina se e quando pedir ao utilizador para estabelecer a ligação e se deve ou não abrir a ligação de forma assíncrona. Você pode usar uma das constantes a seguir.

Constante

Descrição

dbDriverNoPrompt

O Gerenciador de Driver ODBC usa a cadeia de caracteres de conexão fornecida em dbname e connect. Se você não fornecer informações suficientes, ocorrerá um erro em tempo de execução.

dbDriverPrompt

O Gerenciador de driver ODBC exibe a caixa de diálogo Fontes de Dados ODBC, que mostra quaisquer informações relevantes fornecidas em dbname ou connect. A sequência de conexão é composta pelo DSN que o usuário seleciona via caixas de diálogo ou, se o usuário não especificar um DSN, pelo DSN padrão.

dbDriverComplete

Padrão. Se o argumento connect incluir todas as informações necessárias para estabelecer a conexão, o Gerenciador de driver ODBC utilizará a sequência em connect. Caso contrário, ele se comportará da mesma forma como quando você especifica dbDriverPrompt.

dbDriverCompleteRequired

Essa opção se comporta como dbDriverComplete exceto pelo fato de que o driver ODBC desabilita as solicitações para qualquer informação não exigida para estabelecer a conexão.

dbRunAsync

Execute o método de modo assíncrono. Essa constante pode ser usada com quaisquer outras constantes options.

OpenConnection retorna um objeto Connection que contém informações sobre a conexão. O objeto Connection é semelhante ao objeto Database. A principal diferença é que um objeto Database geralmente representa um banco de dados, embora ele possa ser usado para representar uma conexão a uma fonte de dados ODBC a partir de um espaço de trabalho do Microsoft Access.

  • Last updated on