Método DBEngine.OpenConnection (DAO)

Aplica-se ao: Access 2013, Office 2013

Sintaxe

expressão . OpenConnection(Name, Options, ReadOnly, Connect)

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. Consulte a propriedade Connect para obter os elementos específicos e a sintaxe dessa cadeia de caracteres. É 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 você especificar um DSN (nome de fonte de dados) ODBC registrado no argumento de conexão, o argumento de nome poderá ser qualquer cadeia de caracteres válida e também fornecerá a propriedade Name para o objeto Connection . Se um DSN válido não estiver incluído no argumento de conexão, o nome deverá se referir a um DSN ODBC válido, que também será a propriedade Name . Se nem o nome nem a conexão contiver um DSN válido, o gerenciador de driver ODBC poderá ser definido (por meio do argumento de opções) para solicitar ao usuário as informações de conexão necessárias. O DSN é fornecido pela solicitação e depois fornece a propriedade Name.

O argumento de opções determina se e quando solicitar que o usuário estabeleça a conexão e se deve ou não abrir a conexã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.