Comment : ajouter une méthode de recherche

Article
08/10/2011

Pour permettre au service de connectivité de données métiers (BDC, Business Data Connectivity) d'afficher une liste d'entités dans une liste ou un composant WebPart, vous devez créer une méthode de recherche. Une méthode de recherche est une méthode spéciale qui retourne une collection d'instances d'entité. Pour plus d'informations, consultez Conception d'un modèle de connectivité de données métiers.

Pour créer une méthode de recherche

Dans le concepteur BDC, sélectionnez une entité. Pour plus d'informations sur l'ajout d'une entité au concepteur BDC dans Visual Studio, consultez Comment : ajouter une entité à un modèle.
Dans le menu Affichage, cliquez sur Autres fenêtres, puis sur Détails de méthode BDC.

La fenêtre Détails de méthode BDC s'ouvre. Pour plus d'informations sur la fenêtre Détails de méthode BDC, consultez Vue d'ensemble des outils de conception du modèle BDC.
Dans la fenêtre Détails de méthode BDC, dans la liste déroulante Ajouter une méthode, sélectionnez Créer une méthode de recherche.

Visual Studio ajoute une méthode, un paramètre de retour et un descripteur de type.
Configurez le descripteur de type en tant que collection d'entités. Pour plus d'informations sur la création d'un descripteur de type de collection d'entités, consultez Comment : définir le descripteur de type d'un paramètre.

Notes

Vous n'avez pas à effectuer cette étape si vous avez ajouté une méthode de recherche spécifique à l'entité. Visual Studio utilise le descripteur de type que vous avez défini dans la méthode de recherche spécifique.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le fichier de code de service qui a été généré pour l'entité, puis cliquez sur Afficher le 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.

Ajoutez du code à la méthode de recherche. Ce code exécute les tâches suivantes :

Il récupère des données dans une source de données.
Il retourne une liste d'entités au service BDC.

L'exemple suivant retourne une collection d'entités Contact à partir des données 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.

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

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;

}

Partager via

Comment : ajouter une méthode de recherche

Pour créer une méthode de recherche

Voir aussi

Tâches

Concepts

Autres ressources

Ressources supplémentaires