Assistant Consommateur OLE DB ATL

Mise à jour : novembre 2007

L'Assistant Consommateur OLE DB ATL permet de définir 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, par le biais du fournisseur OLE DB indiqué.

Remarque :
Cet Assistant nécessite que vous cliquiez sur le bouton Source de données pour sélectionner une source de données, avant d'entrer des noms dans les champs Class et Fichier .h.

• Source de données
  Le bouton Source de données vous permet de définir la source de données spécifiée à l'aide du fournisseur OLE DB indiqué. 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 génération de chaînes de connexion et la boîte de dialogue Propriétés des liaisons de données, consultez Vue d'ensemble des API de liaison de données dans la documentation du Kit de développement logiciel (SDK) Windows.

  Remarque :
  Dans les versions précédentes, cliquer sur la touche MAJ et sur le bouton Source de données ouvrait une boîte de dialogue d'ouverture de fichier pour vous permettre de sélectionner un fichier .udl. Cette fonctionnalité n'est plus prise en charge.

  La boîte de dialogue se compose de quatre onglets :

  • Onglet Fournisseur

  • Onglet Connexion

  • Onglet Avancé

  • Onglet Tous

• Class
  Une fois que vous avez sélectionné une source de données, cette zone contient 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 la source de données ci-dessous). Vous pouvez modifier le nom de la classe.

• fichier .h
  Une fois que vous avez sélectionné une source de données, cette zone contient 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 la source de données ci-dessous). Vous pouvez modifier le nom du fichier d'en-tête ou sélectionner un fichier d'en-tête existant.

• Avec attributs
  Cette option indique si l'Assistant crée 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 au lieu des déclarations de modèle (il s'agit de l'option par défaut). Lorsque vous désélectionnez cette option, l'Assistant utilise des déclarations de modèle au lieu des attributs.

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

    // 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 la table, et les macros BEGIN_COLUMN_MAP et END_COLUMN_MAP pour créer le mappage de colonnes, par 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 consommateur de Command, l'Assistant utilise les attributs db_source et db_command, ainsi que db_column pour créer le mappage de colonnes, par exemple :

    [
        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 les déclarations de la commande et de la classe d'accesseur de la commande dans le fichier .h de la classe Command, 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 Basic Mechanics of Attributes.

• Type
  Activez l'une de ces cases d'option pour spécifier si la classe de consommateur est dérivée de CTable ou de CCommand.

  • Table
    Sélectionnez cette option si vous voulez utiliser CTable ou db_table pour créer les déclarations de classe de table et d'accesseur de table.

  • Commande
    Sélectionnez cette option si vous voulez utiliser CCommand ou db_command pour créer les déclarations de classe de commande et d'accesseur de commande. Il s'agit du paramètre défini par défaut.

• Prise en charge
  Activez les cases à cocher pour spécifier les types de mises à jour prises en charge par le consommateur (la valeur par défaut correspond à aucune prise en charge). Chacune des options suivantes définit DBPROP_IRowsetChange et les entrées adéquates pour DBPROP_UPDATABILITY dans le mappage de la propriété Set.

  • Modification
    Spécifie que le consommateur prend en charge les mises à jour des données de ligne dans le jeu de lignes.

  • InsER
    Spécifie que le consommateur prend en charge l'insertion de lignes dans le jeu de lignes.

  • Suppression
    Spécifie que le consommateur prend en charge la suppression de lignes dans le jeu de lignes.

Voir aussi

Tâches

Ajout d'un consommateur OLE DB ATL

Concepts

Ajout de fonctionnalités à l'aide des Assistants Code

Référence

Chaînes de connexion et liaisons de données (OLE DB)