CDaoDatabase::Open

virtuel ouvert nulle (LPCTSTR lpszName, BOOL bExclusive = FALSE, BOOL bReadOnly = FALSE, LPCTSTR lpszConnect = _T(""));
jeter (CDaoException, CMemoryException) ;

Paramètres

lpszName

Une expression de chaîne qui est le nom d'un existant Microsoft Jet (.Fichier de base de données MDB). Si le nom du fichier a une extension, il est requis. Si votre réseau prend en charge l'uniform naming convention (UNC), vous pouvez également spécifier un chemin d'accès réseau, tels que "\\\\MYSERVER\\MYSHARE\\MYDIR\\MYDB.MDB ». (Barres obliques inverses doubles sont requis dans les littéraux de chaîne car « \ » est le caractère d'échappement C++.)

Certaines considérations s'appliquent lorsque vous utilisez lpszName. Si elle:

bExclusive

Une valeur booléenne qui est TRUE si la base de données doit être ouvert pour un accès exclusif (non partagé) et FALSE si la base de données doit être ouverte pour un accès partagé. Si vous omettez cet argument, la base de données est ouverte pour un accès partagé.

bReadOnly

Une valeur booléenne qui est TRUE si la base de données doit être ouverte pour l'accès en lecture seule et FALSE si la base de données doit être ouvert pour un accès en lecture/écriture. Si vous omettez cet argument, la base de données est ouverte pour un accès en lecture/écriture. Tous les Jeux d'enregistrements dépendants hérite de cet attribut.

lpszConnect

Une expression de chaîne utilisée pour ouvrir la base de données. Cette chaîne constitue l'ODBC se connecter les arguments. Vous devez fournir les arguments exclusifs et en lecture seule à fournir une chaîne source. Pour la syntaxe, consultez la rubrique « Propriété Connect » dans l'aide de DAO. Si la base de données est une base de données Microsoft Jet (.MDB), cette chaîne est vide (""). La syntaxe de la valeur par défaut — _T("") — fournit la portabilité pour Unicode et ANSI s'appuie votre demande.

Remarques

Vous devez appeler cette fonction membre pour initialiser un objet CDaoDatabase nouvellement construit qui représente une base de données existante. Open associe la base de données à l'objet sous-jacent de DAO. Vous ne pouvez pas utiliser l'objet de base de données pour construire les objets querydef, tabledef ou jeu d'enregistrements jusqu'à ce qu'elle est initialisée. Open ajoute à l'objet de base de données de la collection de bases de données de l'espace associé.

Utiliser les paramètres comme suit:

Pour plus d'informations, consultez la rubrique « Méthode OpenDatabase » dans l'aide de DAO.

&Nbsp important;  Pour améliorer les performances lorsque vous accédez à des bases de données externes, y compris les bases de données ISAM et sources de données ODBC, il est recommandé que vous attacher les tables de la base de données externe à une base de données Microsoft Jet moteur (.MDB) plutôt que de se connecter directement à la source de données.

Il est possible pour une tentative de connexion à temps si, par exemple, l'hôte de SGBD est indisponible. Si la tentative de connexion échoue, Open lève une exception de type CDaoException.

Les autres remarques s'appliquent uniquement aux bases de données ODBC:

Si la base de données est une base de données ODBC et les paramètres de votre appel ouvert ne contiennent pas suffisamment de renseignements pour établir la connexion, le pilote ODBC ouvre une boîte de dialogue pour obtenir les informations nécessaires à l'utilisateur. Lorsque vous appelez Open, votre chaîne de connexion, lpszConnect, est stocké en privé et est disponible en appelant la fonction membre GetConnect.

Si vous le souhaitez, vous pouvez ouvrir votre propre boîte de dialogue avant de vous appelez Ouvrir pour obtenir des informations de l'utilisateur, comme un mot de passe, puis ajoutez ces informations à la chaîne de connexion, que vous passez à Ouvrir. Ou vous souhaitez enregistrer la chaîne de connexion que vous transmettre (peut-être dans le Registre Windows) afin que vous pouvez réutiliser la prochaine fois que votre application appelle ouvert sur un objet CDaoDatabase.

Vous pouvez également utiliser la chaîne de connexion pour plusieurs niveaux d'autorisation de connexion (chacun pour un objet CDaoDatabase différent) ou de transmettre d'autres informations spécifiques à la base de données.

Pour plus d'informations sur les chaînes de connexion, reportez-vous à la rubrique « Propriété Connect » dans l'aide de DAO.

Aperçu CDaoDatabase |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CDatabase::CDatabase, CDatabase::Close

Index