Fournisseur Microsoft OLE DB pour ODBC

S’applique à : Access 2013, Office 2013

Pour un programmeur ADO ou RDS, l'idéal serait que chaque source de données expose une interface OLE DB pour qu'ADO puisse effectuer les appels directement dans la source de données. Même si les fournisseurs de bases de données sont de plus en plus nombreux à implémenter les interfaces OLE DB, certaines sources de données ne sont pas encore exposées de cette façon. Toutefois, tous les systèmes SGBD utilisés aujourd'hui sont en principe accessibles via ODBC.

Il existe des pilotes ODBC pour les principaux SGBD utilisés aujourd'hui, dont Microsoft SQL Server, Microsoft Access (moteur de base de données Microsoft Jet) et Microsoft FoxPro, sans oublier les produits de base de données non-Microsoft comme Oracle.

Le fournisseur Microsoft ODBC permet à ADO de se connecter à n'importe quelle source de données ODBC. Ce fournisseur est libre de thread et utilise Unicode.

Le fournisseur prend en charge les transactions bien que les différents moteurs SGBD offrent différents types de prise en charge de ces transactions. Microsoft Access prend par exemple en charge jusqu'à cinq niveaux de transactions imbriquées.

Il s'agit du fournisseur par défaut pour ADO et toutes les propriétés et méthodes ADO spécifiques au fournisseur sont prises en charge.

Paramètres de la chaîne de connexion

Pour vous connecter à ce fournisseur, définissez l’argument Provider de la propriété ConnectionString sur :

 
MSDASQL 

La lecture de la propriété Provider renverra également cette chaîne.

Chaîne de connexion classique

Voici une chaîne de connexion classique pour ce fournisseur :

 
"Provider=MSDASQL;DSN=dsnName;UID=userName;PWD=userPassword;" 

La chaîne est composée des mots clé suivants :

Comme il s'agit du fournisseur par défaut pour ADO, si vous omettez de spécifier le paramètre Provider= dans la chaîne de connexion, ADO tentera d'établir une connexion vers ce fournisseur.

Ce fournisseur ne prend pas en charge de paramètre de connexion spécifique en plus des paramètres définis par ADO. Il transmettra toutefois tous les paramètres de connexion non-ADO au gestionnaire de pilote ODBC.

Comme vous n'êtes pas obligé de spécifier le paramètre Provider, vous pouvez composer une chaîne de connexion ADO identique à la chaîne de connexion ODBC pour la même source de données. Utilisez les mêmes noms de paramètre (DRIVER=, DATABASE=, DSN=, etc.), les mêmes valeurs et la même syntaxe que pour composer une chaîne ODBC. Vous pouvez vous connecter avec ou sans nom de source de données (DSN) ou DSN de fichier (FileDSN).

Syntaxe avec un DSN ou un FileDSN :

"[Provider=MSDASQL;] { DSN=name | FileDSN=filename } ; [DATABASE=database;] UID=user; PWD=password"

Syntaxe sans DSN (connexion sans DSN) :

"[Provider=MSDASQL;] DRIVER=driver; SERVER=server;DATABASE=database; UID=user; PWD=password"

Si vous utilisez un DSN ou un FileDSN, il doit être défini à travers l'administrateur de source de données ODBC dans le Panneau de configuration de Windows. Dans Microsoft Windows 2000, l'administrateur ODBC se trouve sous Outils d'administration. Dans les versions précédentes de Windows, l'icône de l'administrateur ODBC est appelée ODBC 32 bits ou simplement ODBC .

Plutôt que de définir un DSN, vous pouvez choisir de spécifier le pilote ODBC (DRIVER=), SQL Server par exemple, le nom du serveur (SERVER=) et le nom de la base de données (DATABASE=).

Vous pouvez aussi spécifier un nom de compte utilisateur (UID=) et le mot de passe de ce compte (PWD=) dans les paramètres spécifiques à ODBC ou dans les paramètres ADO standard utilisateur et mot de passe.

Bien qu’une définition DSN spécifie déjà une base de données, vous pouvez spécifier un paramètre de base de données en plus d’un DSN pour vous connecter à une autre base de données. Il est judicieux d’inclure toujours le paramètre de base de données lorsque vous utilisez un DSN. Vous serez ainsi certain de vous connecter à la bonne base de données même si un autre utilisateur a modifié le paramètre de base de données par défaut depuis votre dernière vérification de la définition du DSN.

Propriétés de connexion spécifiques au fournisseur

Le fournisseur OLE DB pour ODBC ajoute plusieurs propriétés à la collection Properties de l'objet Connection. Le tableau suivant répertorie chaque propriété en indiquant entre parenthèses le nom de propriété OLE DB correspondant.

Propriétés spécifiques au fournisseur pour le jeu d'enregistrement et la commande

Le fournisseur OLE DB pour ODBC ajoute plusieurs propriétés à la collection Properties des objets Recordset et Command. Le tableau suivant répertorie chaque propriété en indiquant entre parenthèses le nom de propriété OLE DB correspondant.

Texte de la commande

La façon dont vous utilisez l'objet Command dépend en grande partie de la source de données et du type de requête ou de commande qu'elle accepte.

ODBC fournit une syntaxe spécifique pour appeler les procédures stockées. Pour la propriété CommandText d’un objet Command, l’argument CommandText de la méthode Execute sur un objet Connection ou l’argument Source de la méthode Open sur un objet Recordset transmet une chaîne présentant la syntaxe suivante :

"{ [ ? = ] call procedure [ ( ? [, ? [ , ]] ) ] }"

Chaque ? fait référence à un objet de la collection Parameters. Le premier ? fait référence à l’objet Parameters (0), le ? suivant fait référence à l’objet Parameters (1) et ainsi de suite.

Les références aux paramètres sont facultatives et dépendent de la structure de la procédure stockée. Si vous voulez appeler une procédure stockée qui ne définisse aucun paramètre, votre chaîne doit présenter la syntaxe suivante :

"{ call procedure }"

Si vous avez deux paramètres de requête, votre chaîne aura la syntaxe suivante :

"{ call procedure ( ?, ? ) }"

Si la procédure stockée renvoie une valeur, cette valeur sera traitée comme un paramètre supplémentaire. Si vous n'avez pas de paramètre de requête mais que vous avez une valeur de renvoi, votre chaîne aura la syntaxe suivante :

"{ ? = call procedure }"

Enfin, si vous avez une valeur de renvoi et deux paramètres de requête, votre chaîne aura la syntaxe suivante :

"{ ? = call procedure ( ?, ? ) }"

Comportement des jeux d'enregistrements

Les tableaux suivants répertorient les méthodes et propriétés ADO standard disponibles pour un objet Recordset ouvert avec ce fournisseur.

Pour obtenir des informations détaillées sur le comportement de l'objet Recordset en fonction de la configuration de votre fournisseur, exécutez la méthode Supports et passez en revue la collection Properties du Recordset pour voir s'il existe des propriétés dynamiques spécifiques à ce fournisseur.

Disponibilité des propriétés ADO standard d'un Recordset :

Les propriétés AbsolutePosition et AbsolutePage sont en écriture seule lorsqu’ADO est utilisé avec la version 1.0 du fournisseur Microsoft OLE DB pour ODBC.

Disponibilité des méthodes ADO standard d'un Recordset :

*Non prise en charge avec les bases de données Microsoft Access.

Propriétés dynamiques

Le fournisseur OLE DB pour ODBC insère plusieurs propriétés dynamiques dans la collection Properties des objets Connection, Recordset et Command non ouverts.

Les tableaux suivants forment un index croisé des noms ADO et OLE DB de chaque propriété dynamique. La référence du programmeur OLE DB fait référence à un nom de propriété ADO par le terme « Description ». Vous trouverez plus d’informations sur ces propriétés dans la référence du programmeur OLE DB. Recherchez le nom de la propriété OLE DB dans l'Index ou consultez la rubrique « Appendix C: OLE DB Properties ».

Propriétés dynamiques de connexion

Les propriétés suivantes sont ajoutées à la collection Properties de l'objet Connection.

Propriétés dynamiques du jeu d'enregitrements

Les propriétés suivantes sont ajoutées à la collection Properties de l'objet Recordset.

Propriétés dynamiques de la commande

Les propriétés suivantes sont ajoutées à la collection Properties de l'objet Command.

Voir aussi

Pour plus d’informations sur l’implémentation spécifique et les informations fonctionnelles sur le fournisseur Microsoft OLE DB pour ODBC, consultez le Guide du programmeur OLE DB ou visitez le Centre de développement de la plateforme de données.