Comment : ajouter une méthode de rechercheHow to: Add a Finder method

Pour activer le service de connectivité de données métiers (BDC) afficher une liste d’entités dans une liste ou un composant WebPart, vous devez créer un Finder (méthode).To enable the Business Data Connectivity (BDC) service to display a list of entities in a web part or list, you must create a Finder method. Une méthode de recherche est une méthode spéciale qui retourne une collection d’instances d’entité.A Finder method is a special method that returns a collection of entity instances. Pour plus d’informations, consultez conception d’un modèle de connectivité de données métiers.For more information, see Designing a Business Data Connectivity Model.

Pour créer une méthode de rechercheTo create a Finder method

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

    Pour plus d’informations, consultez Comment : ajouter une entité à un modèle.For more information, 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 la détails de méthode BDC fenêtre, consultez vue d’ensemble des outils de conception du modèle BDC.For more information about the BDC Method Details window, see BDC model design tools overview.

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

    Visual Studio ajoute une méthode, un paramètre de retour et un descripteur de type.Visual Studio adds a method, a return parameter, and a type descriptor.

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

    Note

    Il est inutile d’effectuer cette étape si vous avez ajouté une méthode de recherche spécifique à l’entité.You do not have to perform this step if you have added a Specific Finder method to the entity. Visual Studio utilise le descripteur de type que vous avez défini dans la méthode de recherche spécifique.Visual Studio uses the type descriptor that you defined in the Specific Finder method.

  5. 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. Pour plus d’informations sur le fichier de code de service, consultez créer un modèle de connectivité de données métiers.For more information about the service code file, see Create a business data connectivity model.

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

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

    • Retourne une liste d’entités au service BDC.Returns a list of entities to the BDC service.

      L’exemple suivant retourne une collection de Contact entités à l’aide des données à partir de la base de données AdventureWorks pour SQL Server.The following example returns a collection of Contact entities by using data 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 IEnumerable<Contact> ReadList()
    {
        const string ServerName = "MySQLServerName";
        AdventureWorksDataContext dataContext = new AdventureWorksDataContext
              ("Data Source=" + ServerName + ";" +
               "Initial Catalog=AdventureWorks;Integrated Security=True");
    
        IEnumerable<Contact> Contacts =
            from contacts in dataContext.Contacts.Take(20)
            select contacts;
        return Contacts;
    
    }
    
    Public Shared Function ReadList() As IEnumerable(Of Contact)
        Const ServerName As String = "MySQLServerName"
        Dim dataContext As AdventureWorksDataContext = _
            New AdventureWorksDataContext("Data Source=" & ServerName & _
                ";Initial Catalog=AdventureWorks;Integrated Security=True")
    
        Dim Contacts As IEnumerable(Of Contact) = _
            From TempContacts In dataContext.Contacts.Take(20) _
                  Select TempContacts
        Return Contacts
    End Function
    

Voir aussiSee also

Vue d’ensemble des outils de conception de modèle BDC BDC model design tools overview
Concevoir un modèle de connectivité de données métiers Design a business data connectivity model
Comment : ajouter une méthode de recherche spécifique How to: Add a specific 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
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