Assistant Consommateur OLEDB ATL

Cet Assistant n’est pas disponible dans Visual Studio 2019 et versions ultérieures.

Cet Assistant définit une classe de consommateur OLE DB avec les liaisons de données nécessaires pour accéder à la source de données spécifiée via le fournisseur OLE DB spécifié.

Liste des éléments de l'interface utilisateur

• Source de données

  Le bouton Source de données vous permet de configurer la source de données spécifiée à l’aide du fournisseur OLE DB spécifié. Lorsque vous cliquez sur ce bouton, la boîte de dialogue Propriétés des liaisons de données s’affiche. Pour plus d’informations sur la création de chaînes de connexion et la boîte de dialogue Propriétés des liaisons de données, consultez Data Link API Overview (Présentation de la liaison de données) dans la documentation du SDK Windows.

  Les informations supplémentaires suivantes décrivent les onglets de la boîte de dialogue Propriétés des liaisons de données.

  • Onglet Fournisseur

    Sélectionnez un fournisseur approprié pour gérer la connexion à la source de données. Le type de fournisseur est généralement déterminé par le type de la base de données à laquelle vous vous connectez. Cliquez sur le bouton Suivant ou sur l’onglet Connexion.

  • Onglet Connexion

    Le contenu de cet onglet varie en fonction du fournisseur sélectionné. Bien qu’il existe de nombreux types de fournisseurs, cette section traite des connexions pour les deux données SQL et ODBC les plus courantes. Les autres présentent des variations des champs décrits ici.

    Pour les données SQL :

    1. Sélectionnez ou entrez un nom de serveur : cliquez sur le menu de liste déroulante pour afficher tous les serveurs de données inscrits sur le réseau, puis sélectionnez-en un.

    2. Entrez des informations pour vous connecter au serveur : entrez un nom d’utilisateur et un mot de passe pour vous connecter au serveur de données.

       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 « Entrez des informations pour vous connecter au serveur », deux cases d’option sont disponibles :

       • Utiliser la sécurité intégrée de Windows NT
       • Utiliser un nom d'utilisateur et un mot de passe spécifiques

       Si vous sélectionnez Utiliser un nom d’utilisateur spécifique et un mot de passe, 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, cette option n’est pas sûre. Nous vous recommandons plutôt de sélectionner l’option Utiliser la sécurité intégrée de Windows NT, qui crypte le mot de passe, assurant sa sécurité. Il peut arriver que vous souhaitiez sélectionner « Autoriser l’enregistrement du mot de passe ». Par exemple, si vous publiez une bibliothèque avec une solution de base de données privée, vous ne devez pas accéder directement à la base de données, mais utiliser plutôt une application de niveau intermédiaire pour vérifier l’utilisateur (par le biais du schéma d’authentification que vous choisissez), puis limiter le type de données disponible pour l’utilisateur.

    3. Sélectionnez la base de données sur le serveur : cliquez sur le menu de liste déroulante pour afficher toutes les bases de données inscrites sur le serveur de données, puis sélectionnez-en une.

       - ou -

       Attachez un fichier de base de données en tant que nom de base de données : spécifiez un fichier à utiliser comme base de données ; entrez le chemin d’accès explicite.

    Pour les données ODBC :

    1. Spécifiez la source de données : vous pouvez utiliser un nom de source de données ou un chaîne de connexion.

       Utilisez le nom de la source de données : cette liste déroulante affiche les sources de données inscrites sur votre ordinateur. Vous pouvez configurer des sources de données à l’avance à l’aide de l’administrateur de sources de données ODBC

       - ou -

       Utilisez chaîne de connexion : entrez une chaîne de connexion que vous avez déjà obtenue, ou cliquez sur le bouton Générer . La boîte de dialogue Sélectionner une source de données s’affiche. Sélectionnez une source de données de fichier ou de machine et cliquez sur OK.

       Remarque

       Vous pouvez obtenir une chaîne de connexion en affichant les propriétés d’une connexion existante dans l’Explorateur de serveurs, ou vous pouvez créer une connexion en double-cliquant sur Ajouter une connexion dans l’Explorateur de serveurs.

    2. Entrez des informations pour vous connecter au serveur : entrez un nom d’utilisateur et un mot de passe pour vous connecter au serveur de données.

    3. Saisissez le catalogue initial à utiliser.

    4. Cliquez sur Tester la connexion ; si le test réussit, cliquez sur OK. Si ce n’est pas le cas, vérifiez vos informations d’ouverture de session, ou bien essayez une autre base de données ou un autre serveur de données.

  • Onglet Avancé

    Paramètres réseau : spécifiez le niveau d’emprunt d’identité (niveau d’emprunt d’identité que le serveur est autorisé à utiliser lors de l’emprunt d’identité du client ; correspond directement aux niveaux d’emprunt d’identité RPC) et au niveau de protection (niveau de protection des données envoyées entre le client et le serveur ; correspond directement aux niveaux de protection RPC).

    Autre : Dans le délai d’expiration de connexion, spécifiez le nombre de secondes d’inactivité autorisées avant qu’un délai d’expiration ne se produise. Dans les Autorisations d’accès, spécifiez les autorisations d’accès pour la connexion de données.

    Pour plus d’informations sur les propriétés d’initialisation avancées, reportez-vous à la documentation fournie avec chaque fournisseur OLE DB spécifique.

  • Onglet Tous

    Cet onglet affiche un résumé des propriétés d’initialisation pour la source de données et la connexion que vous avez spécifiées. Vous pouvez modifier ces valeurs.

    Cliquez sur OK pour terminer. La boîte de dialogue Sélectionner l’objet de base de données s’affiche. Dans cette boîte de dialogue, sélectionnez la table, la vue ou la procédure stockée que le consommateur doit utiliser.

• Classe

  Après avoir sélectionné une source de données, cette zone est remplie avec un nom de classe par défaut basé sur la table ou la procédure stockée que vous avez sélectionnée (consultez Sélectionner une source de données ci-dessous). Vous pouvez modifier le nom de classe.

• Fichier .h

  Après avoir sélectionné une source de données, cette zone est remplie avec un nom de classe d’en-tête par défaut basé sur la table ou la procédure stockée que vous avez sélectionnée (consultez Sélectionner une source de données ci-dessous). Vous pouvez modifier le nom de ce fichier d’en-tête ou sélectionner un fichier d’en-tête existant.

• Avec attributs

  Cette option spécifie si l’Assistant va créer des classes de consommateur à l’aide d’attributs ou de déclarations de modèle. Lorsque vous sélectionnez cette option, l’Assistant utilise des attributs plutôt que des déclarations de modèle (il s’agit de l’option par défaut). Lorsque vous décochez cette option, l’Assistant utilise des déclarations de modèle à la place des attributs.

  • Si vous sélectionnez un Type de Table pour le consommateur, l’Assistant utilise les attributs db_source et db_table pour créer la table et les déclarations de classe d’accesseur de la table, et utilise db_column pour créer le mappage de colonnes. Par exemple, il crée ce mappage :

    // Inject table class and table accessor class declarations
    [db_source("<initialization_string>"), db_table("dbo.Orders")]
    ...
    // Column map
    [ db_column(1, status=m_dwOrderIDStatus, length=m_dwOrderIDLength) ] LONG m_OrderID;
    [ db_column(2, status=m_dwCustomerIDStatus, length=m_dwCustomerIDLength) ] TCHAR m_CustomerID[6];
    ...
    

    au lieu d’utiliser la classe de modèle CTable pour déclarer la table et la classe d’accesseur de table, ainsi que les macros BEGIN_COLUMN_MAP et END_COLUMN_MAP pour créer le mappage de colonne, comme dans cet exemple :

    // Table accessor class
        class COrdersAccessor; // Table class
        class COrders : public CTable<CAccessor<COrdersAccessor>>;
    // ...
    // Column map
        BEGIN_COLUMN_MAP(COrderDetailsAccessor)
            COLUMN_ENTRY_LENGTH_STATUS(1, m_OrderID, m_dwOrderIDLength, m_dwOrderIDStatus)
            COLUMN_ENTRY_LENGTH_STATUS(2, m_CustomerID, m_dwCustomerIDLength, m_dwCustomerIDStatus)
            // ...
        END_COLUMN_MAP()
    

  • Si vous sélectionnez un Type de Commande pour le consommateur, l’Assistant utilise les attributs db_source et db_command, et utilise db_column pour créer le mappage de colonnes. Par exemple, il crée ce mappage :

    [db_source("<initialization_string>"), db_command("SQL_command")]
    ...
    // Column map using db_column is the same as for consumer type of 'table'
    

    au lieu d’utiliser la commande et les déclarations de classe d’accesseur de la commande dans le fichier .h de la classe de commande, par exemple :

    // Command accessor class:
        class CListOrdersAccessor;
    // Command class:
        class CListOrders : public CCommand<CAccessor<CListOrdersAccessor>>;
    // ...
    // Column map using BEGIN_COLUMN_MAP ... END_COLUMN_MAP is the same as
    // for consumer type of 'table'
    

    Pour plus d’informations, consultez la mécanique de base des attributs .

• Type

  Sélectionnez l’une de ces cases d’option pour spécifier si la classe de consommateur est dérivée de CTable ou CCommand (valeur par défaut).

  • Enregistrement

    Sélectionnez cette option si vous souhaitez utiliser CTable ou db_table pour créer la table et les déclarations de classe de l’accesseur de table.

  • Interface

    Sélectionnez cette option si vous souhaitez utiliser CCommand ou db_command pour créer la commande et les déclarations de classe de l’accesseur de commande. Il s'agit de la sélection par défaut.

• Support

  Sélectionnez les cases à cocher pour spécifier les types de mises à jour devant être prises en charge dans le consommateur (la valeur par défaut est aucun). Chacun des éléments suivants configure DBPROP_IRowsetChange et les entrées appropriées pour DBPROP_UPDATABILITY dans le mappage d’ensemble des propriétés.

  • Changer

    Spécifie que le consommateur prend en charge les mises à jour des données de ligne dans l’ensemble de lignes.

  • Insérer

    Spécifie que le consommateur prend en charge l’insertion de lignes dans l’ensemble de lignes.

  • Supprimer

    Spécifie que le consommateur prend en charge la suppression de lignes dans l’ensemble de lignes.