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

Pour activer le service de connectivité de données métiers afficher la liste des entités dans une liste ou un composant WebPart, vous devez créer un recherche (méthode).To enable the Business Data Connectivity 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 vous concevez 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. Dans le concepteur BDC, choisissez 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, autres fenêtres, 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 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 que descripteur de type entité collection.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

    Vous n’avez pas à 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éfinie 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 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éation d’un modèle de connectivité de données métiers.For more information about the service code file, see Creating 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

Présentation des outils de conception modèle BDC BDC Model Design Tools Overview
Conception d’un modèle de connectivité de données métiers Designing 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
Guide pratique pour définir une instance de méthodeHow to: Define a Method Instance