Création d'un consommateur simple

L’Assistant Consommateur OLE DB ATL n’est pas disponible dans Visual Studio 2019 et versions ultérieures. Vous pouvez toujours ajouter la fonctionnalité manuellement. Pour plus d’informations, consultez Création d’un consommateur sans utiliser l’Assistant.

Utilisez l’Assistant Projet ATL et l’Assistant Consommateur OLE DB ATL pour générer un consommateur de modèles OLE DB.

Pour créer une application de console pour un consommateur OLE DB

1. Dans le menu Fichier, cliquez sur Nouveau, puis cliquez sur Projet.

   La boîte de dialogue Nouveau projet apparaît.

2. Dans le volet Types de projet, cliquez sur le dossier Installé>Visual C++>Bureau Windows, puis cliquez sur l’icône Assistant Windows Desktop du volet Modèles. Dans le champ Nom, entrez le nom de votre projet, par exemple, MyCons.

3. Cliquez sur OK.

   L’Assistant Projet Windows Desktop s’affiche.

4. Sur la page Paramètres de l’application, sélectionnez Application console, puis Add common header files for ATL (Ajouter des fichiers d’en-tête communs pour ATL).

5. Cliquez sur OK pour fermer l’Assistant et générer le projet.

Ensuite, utilisez l’Assistant Consommateur OLE DB ATL pour ajouter un objet de consommateur OLE DB.

Pour créer un consommateur avec l’Assistant Consommateur OLE DB ATL

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet MyCons.

2. Dans le menu contextuel, cliquez sur Ajouter, puis sur Nouvel élément.

   La boîte de dialogue Ajouter un nouvel élément s’affiche.

3. Dans le volet Catégories, cliquez sur Installé>Visual C++>ATL, puis cliquez sur l’icône Consommateur OLE DB ATL dans le volet Modèles et enfin, cliquez sur Ajouter.

   L’Assistant Consommateur OLE DB ATL s’affiche.

4. Cliquez sur le bouton Source de données.

   La boîte de dialogue Propriétés des liaisons de données apparaît alors.

5. Dans la boîte de dialogue Propriétés des liaisons de données, effectuez ce qui suit :

   1. Dans l’onglet Fournisseur, spécifiez un fournisseur OLE DB.

   2. Dans l’onglet Connexion, spécifiez les informations requises, telles que le nom du serveur, l’ID d’ouverture de session et le mot de passe de votre source de données et base de données sur le serveur.

      Remarque

      Il existe un problème de sécurité avec la fonctionnalité Autoriser l’enregistrement du mot de passe de la boîte de dialogue Propriétés des liaisons de données. Dans Entrer des informations pour vous connecter au serveur, il existe deux cases d’option : Utiliser la sécurité intégrée de Windows NT et utiliser un nom d’utilisateur et un mot de passe spécifiques.

      Remarque

      Si vous sélectionnez Utiliser un nom d’utilisateur et un mot de passe spécifiques, vous avez la possibilité d’enregistrer le mot de passe (à l’aide de la case à cocher Autoriser l’enregistrement du mot de passe) ; néanmoins, c’est option n’est pas la plus sûre. Nous vous recommandons plutôt de sélectionner l’option Utiliser la sécurité intégrée de Windows NT, qui utilise Windows NT pour vérifier votre identité.

      Remarque

      Si vous ne pouvez pas utiliser la sécurité intégrée de Windows NT, vous devez utiliser une application de niveau intermédiaire pour inviter l’utilisateur à fournir son mot de passe ou pour stocker le mot de passe dans un emplacement avec des mécanismes de sécurité permettant de le protéger (plutôt que dans le code source).

   3. Après avoir sélectionné votre fournisseur et les autres paramètres, cliquez sur Tester la connexion pour vérifier les sélections effectuées dans les pages précédentes de la boîte de dialogue. Si le champ Résultats indique Test connection succeeded, cliquez sur OK pour créer la liaison de données.

   La boîte de dialogue Sélectionner l’objet de base de données s’affiche.

6. Utilisez le contrôle d’arborescence pour sélectionner une table, un affichage ou une procédure stockée. Pour cet exemple, sélectionnez la table Products de la base de données Northwind.

7. Cliquez sur OK. Cela vous renvoie vers l’Assistant Consommateur OLE DB ATL.

8. L’Assistant renseigne les noms de Class et du fichier .h en fonction du nom de la table, de l’affichage ou de la procédure stockée que vous avez sélectionnés. Vous pouvez modifier ces noms si vous le souhaitez.

9. Décochez la case Avec attributs pour que l’Assistant puisse créer le code du consommateur à l’aide des classes du modèle OLE DB, plutôt qu’avec les attributs de consommateur OLE DB par défaut.

10. Sous Type, sélectionnez Command.

    L’Assistant crée un consommateur basé sur CCommand si vous sélectionnez Command ou un consommateur basé sur CTable si vous sélectionnez Table. Le nom de la classe command ou table dépend de l’objet sélectionné, mais vous pouvez le modifier.

11. Sous Prise en charge, laissez les cases Modifier, Insérer et Supprimer décochées.

    Cochez les cases Modifier, Insérer et Supprimer pour prendre en charge la modification, l’insertion et la suppression des enregistrements dans l’ensemble de lignes. Pour plus d’informations sur l’écriture de données dans le magasin de données, consultez Updating Rowsets (Mise à jour des ensembles de lignes).

12. Cliquez sur Terminer pour créer le consommateur.

L’Assistant génère une classe command et une classe user record, comme indiqué dans Classes de consommateur générées par l’Assistant. La classe command prend le nom que vous avez entré dans le champ Class (ici, CProducts), tandis que la classe user record prend un nom au format « NomClasseAccessor » (ici, CProductsAccessor).

#error Security Issue: The connection string may contain a password