Comment : ajouter une méthode de recherche spécifique

Vous pouvez retourner une seule instance d'entité en créant une méthode de recherche spécifique.Le service de (BDC) de connectivité de données métiers exécute la méthode de recherche spécifique lorsqu'un utilisateur sélectionne une entité de données métiers composant WebPart ou une liste externe.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 spécifique

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 la barre de menus, sélectionnez Afficher, Autres fenêtres, Détails de méthode BDC.

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

Visual Studio ajoute les éléments suivants au modèle.Ces éléments apparaissent dans la fenêtre Détails de méthode BDC.
- Méthode
- Paramètre d'entrée pour la méthode
- Paramètre de retour pour la méthode
- Descripteur de type pour chaque paramètre
- Instance de méthode pour la méthode
Pour plus d'informations, consultez Conception d'un modèle de connectivité de données métiers.
Ouvrez la fenêtre Propriétés de Visual Studio.
Configurez le descripteur de type du paramètre de retour en tant que descripteur de type entité.Pour plus d'informations sur la création d'un descripteur de type entité, consultez Comment : définir le descripteur de type d'un paramètre.

[!REMARQUE]

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

[!REMARQUE]

Si le champ d'identificateur du type d'entité représente un champ d'une table de base de données qui est généré automatiquement, affectez à la propriété Lecture seule du champ d'identificateur à True.
Dans la fenêtre détails de méthode , choisissez l'instance de méthode de la méthode.
Dans Fenêtre Propriétés, affectez le nom du paramètre de retour de la méthode à la propriété Nom du paramètre de retour.Pour plus d'informations sur les propriétés d'instance de méthode, consultez MethodInstance (page éventuellement en anglais).
Dans Explorateur de solutions, ouvrez le menu contextuel du fichier de code de service qui a été généré pour l'entité, puis choisissez Afficher le code.

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

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

Récupère un enregistrement 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.

[!REMARQUE]

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

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

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

Comment : ajouter une méthode de recherche spécifique

Pour créer une méthode de recherche spécifique

Voir aussi

Tâches

Concepts

Autres ressources

Ressources supplémentaires