Vue d’ensemble de Fournisseur Microsoft OLE DB pour ODBC

Pour un programmeur ADO ou RDS, un monde idéal serait un monde dans lequel chaque source de données expose une interface OLE DB, afin que ADO puisse appeler directement dans la source de données. Bien que de plus en plus de fournisseurs de base de données implémentent des interfaces OLE DB, certaines sources de données ne sont pas encore exposées de cette façon. Toutefois, la plupart des systèmes SGBD utilisés aujourd’hui sont accessibles via ODBC.

Les pilotes ODBC sont disponibles pour chaque SGBD majeur utilisé aujourd’hui, notamment Microsoft SQL Server, Microsoft Access (moteur de base de données Microsoft Jet) et Microsoft FoxPro, en plus des produits de base de données non Microsoft tels qu’Oracle.

Toutefois, le fournisseur MICROSOFT ODBC permet à ADO de se connecter à n’importe quelle source de données ODBC. Le fournisseur est activé avec threads libres et Unicode.

Le fournisseur prend en charge les transactions, bien que différents moteurs SGBD offrent différents types de prise en charge des transactions. Par exemple, Microsoft Access prend en charge les transactions imbriquées jusqu’à cinq niveaux de profondeur.

Il s’agit du fournisseur par défaut pour ADO, et toutes les propriétés et méthodes ADO dépendantes du fournisseur sont prises en charge.

Paramètres de 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é Fournisseur retourne également cette chaîne.

Chaîne de connexion typique

Une chaîne de connexion classique pour ce fournisseur est la suivante :

"Provider=MSDASQL;DSN=dsnName;UID=MyUserID;PWD=MyPassword;"

La chaîne se compose des mots clés suivants :

Étant donné qu’il s’agit du fournisseur par défaut pour ADO, si vous omettez le paramètre Provider= de la chaîne de connexion, ADO tente d’établir une connexion à ce fournisseur.

Le fournisseur ne prend pas en charge des paramètres de connexion spécifiques au fournisseur en plus de ceux définis par ADO. Toutefois, le fournisseur transmet tous les paramètres de connexion non ADO au gestionnaire de pilotes ODBC.

Comme vous pouvez omettre le paramètre Provider, vous pouvez donc composer une chaîne de connexion ADO identique à une chaîne de connexion ODBC pour la même source de données. Utilisez les mêmes noms de paramètres (DRIVER=, DATABASE=, DSN=, et ainsi de suite), les valeurs et la syntaxe que vous le feriez lors de la composition d’une chaîne de connexion ODBC. Vous pouvez vous connecter avec ou sans nom de source de données prédéfini (DSN) ou FileDSN.

Syntaxe avec un DSN ou 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=MyUserID; PWD=MyPassword"

Notes

Si vous utilisez un DSN ou FileDSN, il doit être défini via 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 antérieures de Windows, l’icône Administrateur ODBC est nommée ODBC 32 bits ou simplement ODBC.

En guise d’alternative à la définition d’un DSN, vous pouvez spécifier le pilote ODBC (DRIVER=), tel que « SQL Server; » le nom du serveur (SERVER=) et le nom de la base de données (DATABASE=).

Vous pouvez également spécifier un nom de compte d’utilisateur (UID=) et le mot de passe du compte d’utilisateur (PWD=) dans les paramètres spécifiques à ODBC ou dans les paramètres utilisateur et mot de passe définis par ADO standard.

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 se 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. Cela garantit que vous vous connectez à la base de données correcte si un autre utilisateur a modifié le paramètre de base de données par défaut depuis que vous avez vérifié la définition DSN pour la dernière fois.

Propriétés de connexion spécifique 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 ces propriétés avec le nom de propriété OLE DB correspondant entre parenthèses.

Recordset spécifique au fournisseur et propriétés de 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 ces propriétés avec le nom de propriété OLE DB correspondant entre parenthèses.

Texte de la commande

L’utilisation de l’objet Command dépend en grande partie de la source de données et du type de requête ou d’instruction de commande qu’il accepte.

ODBC fournit une syntaxe spécifique pour appeler des procédures stockées. Pour la propriété CommandText d’un objet Command, l’argument CommandText à la méthode Execute sur un objet Connection ou l’argument Source de la méthode Open sur un objet Recordset, passe dans une chaîne avec cette syntaxe :

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

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

Les références de paramètre sont facultatives et dépendent de la structure de la procédure stockée. Si vous souhaitez appeler une procédure stockée qui ne définit aucun paramètre, votre chaîne ressemble à ce qui suit :

"{ call procedure }"

Si vous avez deux paramètres de requête, votre chaîne ressemble à ce qui suit :

"{ call procedure ( ?, ? ) }"

Si la procédure stockée retourne une valeur, la valeur de retour est traitée comme un autre paramètre. Si vous n’avez aucun paramètre de requête, mais que vous disposez d’une valeur de retour, votre chaîne ressemble à ce qui suit :

"{ ? = call procedure }"

Enfin, si vous avez une valeur de retour et deux paramètres de requête, votre chaîne ressemble à ce qui suit :

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

Comportement de recordset

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

Pour plus d’informations sur le comportement de Recordset pour la configuration de votre fournisseur, exécutez la méthode Supports et énumérez la collection Propriétés de l’objet Recordset pour déterminer si les propriétés dynamiques spécifiques au fournisseur sont présentes.

Disponibilité des propriétés d’objet Recordset ADO standard :

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

Disponibilité des méthodes Recordset ADO standard :

*Non pris en charge pour les bases de données Microsoft Access.

Propriétés dynamiques

Le fournisseur Microsoft 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 sont des index croisés 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 de plus amples 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 l’Annexe C : Propriétés OLE DB.

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 recordset

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.

Pour plus d’informations sur l’implémentation spécifique et les informations fonctionnelles sur le fournisseur Microsoft OLE DB pour ODBC, consultez la référence du programmeur OLE DB ou visitez le site web du Centre de développement d’accès aux données et de stockage sur MSDN.

Voir aussi

Objet Command (ADO)Propriété CommandText (ADO)Objet Connection (ADO)Propriété ConnectionString (ADO)Méthode Execute (commande ADO)Méthode Open (ADO Recordset)Collection Parameters (ADO)Collection Properties (ADO)Propriété Provider (ADO)Objet Recordset (ADO)Méthodes Supports