DBEngine.OpenConnection, méthode (DAO)

S’applique à : Access 2013, Office 2013

Syntaxe

expression . OpenConnection(Name, Options, ReadOnly, Connect)

expression Variable représentant un objet DBEngine.

Paramètres

Nom	Obligatoire/facultatif	Type de données	Description
Name	Obligatoire	String	Expression de chaîne. Reportez-vous à la section sous Notes.
Options	Facultatif	Variant	Définit différentes options pour la connexion, selon les indications dans les notes. En fonction de cette valeur, le gestionnaire de pilotes ODBC invite l'utilisateur à indiquer les informations de connexion comme le nom de la source de données (DSN), le nom d'utilisateur et le mot de passe.
ReadOnly	Facultatif	Variant	True si la connexion doit être ouverte pour un accès en lecture seule et False si la connexion doit être ouverte pour un accès en lecture/écriture (valeur par défaut).
Connect	Facultatif	Variant	Chaîne de connexion ODBC. Consultez la propriété Connect pour connaître les éléments spécifiques et la syntaxe de cette chaîne. Une connexion "ODBC;" en attente est indispensable.

Valeur renvoyée

Connection

Remarques

Utilisez la méthode OpenConnection pour définir une connexion à une source de données ODBC à partir d'un espace de travail ODBCDirect. La méthode OpenConnection est similaire à la méthode OpenDatabase, mais elle n'y est pas équivalente. La différence principale est que la méthode OpenConnection est disponible dans un espace de travail ODBCDirect.

Si vous spécifiez un nom de source de données ODBC (DSN) inscrit dans l’argument connect, l’argument name peut être n’importe quelle chaîne valide et fournit également la propriété Name pour l’objet Connection . Si un DSN valide n’est pas inclus dans l’argument connect, name doit faire référence à un DSN ODBC valide, qui sera également la propriété Name . Si ni name ni connect ne contiennent de DSN valide, le gestionnaire de pilotes ODBC peut être défini (via l’argument options) pour inviter l’utilisateur à entrer les informations de connexion requises. Le nom DSN indiqué à l'invite fournit ensuite la propriété Name.

L’argument options détermine si et quand inviter l’utilisateur à établir la connexion et s’il faut ou non ouvrir la connexion de façon asynchrone. Vous pouvez utiliser l'une des constantes ci-après.

Constante	Description
dbDriverNoPrompt	Le gestionnaire de pilotes ODBC utilise la chaîne de connexion fournie dans dbname et connect. Si vous ne fournissez pas suffisamment d’informations, une erreur d’exécution se produit.
dbDriverPrompt	Le gestionnaire de pilotes ODBC affiche la boîte de dialogue Sources de données ODBC, qui affiche les informations pertinentes fournies dans dbname ou connect. La chaîne de connexion est composée du DSN que l'utilisateur sélectionné par le biais des boîtes de dialogue, ou, si l'utilisateur ne spécifie pas de DSN, c'est le DSN par défaut qui est utilisé.
dbDriverComplete	Valeur par défaut. Si l'argument connect inclut toutes les informations nécessaires pour établir une connexion, le gestionnaire de pilotes ODBC utilise la chaîne dans connect. Autrement, il se comporte comme lorsque vous spécifiez dbDriverPrompt.
dbDriverCompleteRequired	Cette option se comporte comme dbDriverComplete sauf que le pilote ODBC désactive les invites pour les informations qui ne sont pas nécessaires à l'établissement de la connexion.
dbRunAsync	Exécute la méthode en mode asynchrone. Cette constante peut être utilisée avec n'importe quelles autres constantes options.

OpenConnection renvoie un objet Connection qui contient des informations relatives à la connexion. L'objet Connection est similaire à un objet Database. La différence principale réside dans le fait qu'un objet Database représente généralement une base de données, même s'il peut être utilisé pour représenter une connexion à une source de données ODBC issue d'un espace de travail Microsoft Access.