Partager via

Utiliser un adaptateur SDK de l’adaptateur LOB WCF dans un projet .NET

  • Article

Pour utiliser un adaptateur créé à l’aide du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF à partir de Visual Studio, vous devez ajouter une référence de service au projet. Pour ce faire, vous pouvez :

  • Utilisation du plug-in Visual Studio Add Adapter Service Reference, qui est installé dans le cadre du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF.

  • Utilisation de svcutil.exe (l’utilitaire de métadonnées ServiceModel), qui est installé dans le cadre du Kit de développement logiciel (SDK) Windows.

Ajouter une référence de service à l’aide du plug-in Add Adapter Service Reference

Le plug-in Add Adapter Service Reference peut être utilisé pour parcourir et rechercher des métadonnées, et pour générer des classes de proxy .NET CLR à l’aide des opérations et des types sélectionnés.

  1. Ouvrez votre application .NET dans Visual Studio.

  2. Dans Visual Studio, cliquez avec le bouton droit sur le menu Projet , puis cliquez sur Ajouter une référence de service d’adaptateur.

    Notes

    Cette option n’apparaît pas pour les projets BizTalk Server.

  3. Dans l’écran Ajouter un plug-in de référence de service d’adaptateur, dans la liste déroulante Sélectionner une liaison , sélectionnez une liaison d’adaptateur.

  4. Pour configurer l’URI de connexion pour la liaison d’adaptateur sélectionnée et fournir des informations d’identification, des propriétés d’URI et des propriétés de liaison, cliquez sur Configurer. Les exigences réelles varient en fonction de la liaison d’adaptateur sélectionnée.

  5. Une fois que vous avez configuré l’URI, cliquez sur OK.

  6. Cliquez sur Connecter. Si l’URI de connexion est valide et que les informations d’identification du client (le cas échéant) sont acceptées, le volet Catégorie doit être rempli avec les catégories et les opérations fournies par l’adaptateur.

  7. Si l’adaptateur prend en charge la recherche, le champ de recherche est actif. Sinon, vous pouvez filtrer par type de contrat, explorer les types et les opérations en cliquant sur nœuds dans le volet Catégorie .

  8. Pour les options avancées de génération de proxy, cliquez sur Avancé. Les options disponibles sont les suivantes :

    Option Option de svcutil.exe équivalente Description
    Générer des méthodes asynchrones /async Génère à la fois des signatures de méthode synchrones et asynchrones.

    Par défaut (s’il n’est pas sélectionné) : génère uniquement les signatures de méthode synchrone.
    Générer des contrats de message /messageContract Génère des types de contrats de message.
    Rendre les types internes /internal Génère des classes marquées comme internes.

    Par défaut (s’il n’est pas sélectionné) : générez des classes publiques.
    Activer la liaison de données /enableDataBinding Implémente l’interface System.ComponentModel.INotifyPropertyChanged sur tous les types de contrats de données pour activer la liaison de données.
    Importer des types non-données en tant que IXmlSerializable /importXmlTypes Configure le sérialiseur de contrat de données de façon à importer des types autres que le type de contrat de données en tant que types IXmlSerializable.
    Générer l’interface de canal Génère l’interface de canal.
    Marquer les classes sérialisables Indique s’il faut générer les types de données avec un sérialiseur.
    Ne pas générer de app.config /noConfig Ne génère pas de fichier de configuration d’application.
    serializer

    Automatique    		 /serializer:Auto Sélectionne automatiquement le sérialiseur pour la sérialisation et la désérialisation.
    serializer

    Sérialiseur DataContract    		 /serializer:DataContractSerializer Génère des types de données qui utilisent le sérialiseur de contrat de données pour la sérialisation et la désérialisation
    serializer

    Xmlserializer    		 /serializer:XmlSerializer Génère des types de données qui utilisent xmlSerializer pour la sérialisation et la désérialisation.

  9. Pour générer les artefacts proxy, cliquez sur OK. Le nombre d’artefacts varie en fonction du type de contrat.

    Type de contrat Artefact Description
    Règle de trafic sortant CLR WCF Proxy Contient l’implémentation du contrat et du service.
    Règle de trafic sortant App.config Contient le point de <terminaison> et <les éléments de liaison pour <> le système. Client ServiceModel><>.
    Trafic entrant Interface du service WCF CLR Contient le contrat.
    Trafic entrant Implémentation du service WCF CLR Implémentation stub qui dérive du contrat.
    Trafic entrant App.config Contient le point de terminaison, les liaisons> et <les éléments de> comportement pour le <système. <>< ServiceModel><>.

  10. Vous pouvez maintenant utiliser le proxy dans votre application.

Ajout d’une référence de service à l’aide de svcutil.exe

Svcutil.exe est un utilitaire de ligne de commande qui peut être utilisé pour récupérer des métadonnées et générer des classes proxy CLR .NET, qui peuvent ensuite être ajoutées à un projet Visual Studio. Pour plus d’informations sur svcutil.exe, consultez ServiceModel Metadata Utility Tool (Svcutil.exe).

Pour générer une classe proxy à partir d’un adaptateur hébergé dans IIS

  1. À l’invite de commandes, entrez svcutil.exe «<http://localhost/adapter/AdapterService.svc?wsdl »> /config:app.config. Remplacez le chemin HTTP par le chemin d’accès approprié pour votre adaptateur hébergé. Cela crée un fichier .cs qui contient le proxy CLR .NET et output.config qui contient les liaisons et le <point de terminaison> client <pour <system.serviceModel>.>

    Notes

    Si votre adaptateur contient de nombreuses opérations, vous pouvez limiter les opérations retournées à l’aide d’une chaîne de requête « op= » suivie du nom de l’opération qui vous intéresse. Par exemple : svcutil.exe “http://localhost/adapter/AdapterService.svc?wsdl&op=Echo/EchoString&op=Echo/EchoArray” génère du code proxy pour les opérations EchoString et EchoArray uniquement.

  2. Ouvrez votre projet dans Visual Studio.

    1. Dans Explorateur de solutions, cliquez avec le bouton droit sur le projet, pointez sur Ajouter, puis cliquez sur Nouvel élément. Dans la boîte de dialogue Ajouter un élément existant , sélectionnez les fichiers .cs et app.config créés précédemment. Cliquez sur Add.

    2. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Références, puis cliquez sur Ajouter une référence. Sous l’onglet .NET , sélectionnez System.ServiceModel, puis cliquez sur OK. Vous pouvez maintenant utiliser le proxy dans votre application.

Voir aussi

Didacticiel 1 : Développer l’adaptateur Echo
Utiliser un adaptateur créé à l’aide du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF