Comment : ajouter une méthode de recherche spécifiqueHow to: Add a specific Finder method

Vous pouvez retourner une seule instance d’entité en créant un recherche spécifique (méthode).You can return a single entity instance by creating a Specific Finder method. Le service de connectivité de données métiers (BDC) exécute la méthode de recherche spécifique lorsqu’un utilisateur choisit une entité dans un composant WebPart données métier ou d’une liste externe.The Business Data Connectivity (BDC) service executes the Specific Finder method when a user chooses an entity in a business data web part or external list. Pour plus d’informations, consultez concevoir un modèle de connectivité de données métiers.For more information, see Design a business data connectivity model.

Pour créer une méthode de recherche spécifiqueTo create a specific Finder method

  1. Sur le concepteur BDC, choisir une entité.On the BDC Designer, choose an entity.

    Pour plus d’informations sur l’ajout d’une entité à la concepteur BDC dans Visual Studio, consultez Comment : ajouter une entité à un modèle.For information about how to add an entity to the BDC Designer in Visual Studio, see How to: Add an entity to a model.

  2. Dans la barre de menus, choisissez vue > Windows autres, détails de méthode BDC.On the menu bar, choose View > Other Windows, BDC Method Details.

    Le détails de méthode BDC fenêtre s’ouvre.The BDC Method Details window opens. Pour plus d’informations sur cette fenêtre, consultez vue d’ensemble des outils de conception du modèle BDC.For more information about that window, see BDC model design tools overview.

  3. Dans le ajouter une méthode , choisissez créer une méthode de recherche spécifique.In the Add a Method list, choose Create Specific Finder Method.

    Visual Studio ajoute les éléments suivants au modèle.Visual Studio adds the following elements to the model. Ces éléments apparaissent dans le détails de méthode BDC fenêtre.These elements appear in the BDC Method Details window.

    • Une méthode.A method.

    • Un paramètre d’entrée pour la méthode.An input parameter for the method.

    • Un paramètre de retour pour la méthode.A return parameter for the method.

    • Un descripteur de type pour chaque paramètre.A type descriptor for each parameter.

    • Une instance de méthode pour la méthode.A method instance for the method.

      Pour plus d’informations, consultez concevoir un modèle de connectivité de données métiers.For more information, see Design a business data connectivity model.

  4. Ouvrez Visual Studio propriétés fenêtre.Open the Visual Studio Properties window.

  5. Configurez le descripteur de type du paramètre de retour comme un descripteur de type d’entité.Configure the type descriptor of the return parameter as an entity type descriptor. Pour plus d’informations sur la création d’un descripteur de type d’entité, consultez Comment : définir le descripteur de type d’un paramètre.For information about how to create an entity type descriptor, see How to: Define the type descriptor of a parameter.

    Note

    Vous n’êtes pas obligé d’effectuer cette étape si vous avez ajouté une méthode de recherche à l’entité.You don't have to perform this step if you have added a Finder method to the entity. Visual Studio utilise le descripteur de type que vous avez défini dans la méthode de recherche.Visual Studio uses the type descriptor that you defined in the Finder method.

    Note

    Si le champ d’identificateur du type d’entité représente un champ dans une table de base de données qui est généré automatiquement, définissez la en lecture seule propriété du champ d’identificateur à True.If the identifier field of the entity type represents a field in a database table that's automatically generated, set the Read-only property of the identifier field to True.

  6. Dans le détails de la méthode fenêtre, choisissez l’instance de méthode de la méthode.In the Method Details window, choose the method instance of the method.

  7. Dans le fenêtre Propriétés, définissez le retourner un nom de paramètre propriété le nom du paramètre de retour de la méthode.In the Properties Window, set the Return Parameter Name property to the name of the return parameter of the method. Pour plus d’informations sur les propriétés d’instance de méthode, consultez MethodInstance.For more information about method instance properties, see MethodInstance.

  8. Dans l’Explorateur de solutions, ouvrez le menu contextuel du service du fichier de code qui a été généré pour l’entité, puis choisissez afficher le Code.In Solution Explorer, open the shortcut menu of the service code file that was generated for the entity, and then choose View Code.

    Le fichier de code de service entité s’ouvre dans l’éditeur de Code.The entity service code file opens in the Code Editor. Pour plus d’informations sur le fichier de code de service entité, consultez créer un modèle de connectivité de données métiers.For more information about the entity service code file, see Create a business data connectivity model.

  9. Ajoutez le code à la méthode de recherche spécifique.Add code to the Specific Finder method. Ce code exécute les tâches suivantes :This code performs the following tasks:

    • Récupère un enregistrement à partir d’une source de données.Retrieves a record from a data source.

    • Retourne une entité au service BDC.Returns an entity to the BDC service.

      L’exemple suivant retourne un contact à partir de la base de données AdventureWorks pour SQL Server.The following example returns a contact from the AdventureWorks sample database for SQL Server.

      Note

      Remplacez la valeur de la ServerName champ avec le nom de votre serveur.Replace the value of the ServerName field with the name of your server.

      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;
      }
      
      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
      

Voir aussiSee also

Concevoir un modèle de connectivité de données métiers Design a business data connectivity model
Comment : ajouter une méthode de recherche How to: Add a Finder method
Comment : ajouter une méthode de création How to: Add a Creator method
Comment : ajouter une méthode de suppression How to: Add a Deleter method
Comment : ajouter une méthode de mise à jour How to: Add an Updater method
Vue d’ensemble des outils de conception de modèle BDC BDC model design tools overview
Comment : ajouter un paramètre à une méthode How to: Add a parameter to a method
Comment : définir une instance de méthodeHow to: Define a method instance