Ajouter une méthode de recherche spécifique

Vous pouvez retourner une instance d’entité unique en créant une méthode Finder spécifique. Le service Business Data Connectivity (BDC) exécute la méthode Finder spécifique lorsqu’un utilisateur choisit une entité dans un composant WebPart de données métiers ou une liste externe. Pour plus d’informations, consultez Concevoir un modèle Business Data Connectivity.

Créer une méthode Finder spécifique

1. Dans le Concepteur BDC, choisissez une entité.

   Pour plus d’informations sur l’ajout d’une entité au Concepteur BDC dans Visual Studio, consultez Guide pratique pour ajouter une entité à un modèle.

2. Dans la barre de menus, cliquez sur Affichage>, Autres fenêtres, Détails de méthode BDC.

   La fenêtre Détails de la méthode BDC s’ouvre. Pour plus d’informations sur cette fenêtre, consultez Vue d’ensemble des outils de conception de modèle BDC.

3. Dans la liste Ajouter une méthode, choisissez Créer une méthode Finder spécifique.

   Visual Studio ajoute les éléments suivants au modèle. Ces éléments s’affichent dans la fenêtre Détails de la méthode BDC.

   • Une méthode.

   • Un paramètre d’entrée pour la méthode.

   • Un paramètre de retour pour la méthode.

   • Un descripteur de type pour chaque paramètre.

   • Une instance de méthode pour la méthode.

     Pour plus d’informations, consultez Concevoir un modèle Business Data Connectivity.

4. Ouvrez la fenêtre Propriétés de Visual Studio.

5. Configurez le descripteur de type du paramètre de retour en tant que descripteur de type d’entité. Pour plus d’informations sur la création d’un descripteur de type d’entité, consultez Guide pratique pour définir le descripteur de type d’un paramètre.

   Notes

   Vous n’avez pas besoin d’effectuer cette étape si vous avez ajouté une méthode Finder à l’entité. Visual Studio utilise le descripteur de type que vous avez défini dans la méthode Finder.

   Notes

   Si le champ d’identificateur du type d’entité représente un champ dans une table de base de données générée automatiquement, définissez la propriété En lecture seule du champ d’identificateur sur True.

6. Dans la fenêtre Détails de la méthode, choisissez l’instance de méthode de la méthode.

7. Dans la fenêtre Propriétés,, définissez la propriété Nom du paramètre de retour sur le nom du paramètre de retour de la méthode. Pour plus d’informations sur les propriétés d’instance de méthode, consultez MethodInstance.

8. Dans l’Explorateur de solutions, ouvrez le menu contextuel du fichier de code de service généré pour l’entité, puis choisissez Afficher le code.

   Le fichier de code du service d’entité s’ouvre dans l’Éditeur de code. Pour plus d’informations sur le fichier de code du service d’entité, consultez Créer un modèle de connectivité des données métiers.

9. Ajoutez du code à la méthode Finder spécifique. Ce code effectue les tâches suivantes :

   • Récupère un enregistrement à partir d’une source de données.

   • Retourne une entité au service BDC.

     L’exemple suivant retourne un contact à partir de l’exemple de base de données AdventureWorks pour SQL Server.

     Notes

     Remplacez la valeur du champ ServerName par le nom de votre serveur.

     C#

     public static Contact ReadItem(int contactID)
     {
         const string ServerName = "MySQLServerName";
         AdventureWorksDataContext dataContext = new AdventureWorksDataContext
               ("Data Source=" + ServerName + ";" +
                "Initial Catalog=AdventureWorks;Integrated Security=True");
     
         Contact Contact =
             (from contacts in dataContext.Contacts.AsEnumerable().Take(20)
              where contacts.ContactID == contactID
              select contacts).Single();
         return Contact;
     }
     

     VB

     Public Shared Function ReadItem(ByVal contactID As Integer) As Contact
         Const ServerName As String = "MySQLServerName"
         Dim dataContext As AdventureWorksDataContext = _
             New AdventureWorksDataContext("Data Source=" & ServerName & _
                 ";Initial Catalog=AdventureWorks;Integrated Security=True")
     
         Dim Contact As Contact = _
             (From TempContacts In dataContext.Contacts.AsEnumerable().Take(20) _
             Where TempContacts.ContactID = contactID _
             Select TempContacts).[Single]()
         Return Contact
     End Function
     

   ---

Contenu connexe

• Concevoir un modèle Business Data Connectivity
• Guide pratique pour ajouter une méthode Finder
• Guide pratique pour ajouter une méthode de création
• Guide pratique pour ajouter une méthode de suppression
• Guide pratique pour ajouter une méthode de mise à jour
• Vue d’ensemble des outils de conception de modèle BDC
• Guide pratique pour ajouter un paramètre à une méthode
• Guide pratique pour définir une instance de méthode