Générer un client WCF ou un contrat de service WCF pour les artefacts SQL Server
Vous pouvez utiliser le plug-in Visual Studio Add Adapter Service pour générer une classe de client WCF ciblée sur les opérations sélectionnées sur SQL Server artefacts. Vous pouvez également utiliser l’outil Utilitaire de métadonnées ServiceModel (svcutil.exe) pour générer la classe de client WCF ; toutefois, le plug-in Add Adapter Service Reference expose les fonctionnalités de l’outil Utilitaire de métadonnées ServiceModel via une interface Microsoft Windows standard. Il fournit également des fonctionnalités de navigation et de recherche qui ne sont pas disponibles avec l’outil svcutil.exe, et génère un fichier de configuration basé sur les propriétés de liaison que vous sélectionnez lorsque vous vous connectez à la base de données SQL Server.
Génération d’une classe de client WCF à l’aide du plug-in Add Adapter Service Reference
Effectuez les étapes suivantes pour générer une classe de client WCF à l’aide du plug-in Add Adapter Service Reference.
Dans Visual Studio Explorateur de solutions, cliquez avec le bouton droit sur votre projet, puis cliquez sur Ajouter une référence du service d’adaptateur.
Une fois la boîte de dialogue Ajouter une référence de service d’adaptateur ouverte, suivez les étapes décrites dans Obtenir des métadonnées pour SQL Server opérations dans Visual Studio à l’aide de l’adaptateur SQL pour se connecter à SQL Server et pour parcourir et rechercher des opérations. Pour créer une classe de client WCF pour les opérations que vous sélectionnez, assurez-vous que Client (opérations sortantes) est sélectionné dans la liste déroulante Sélectionner un type de contrat . (Il s’agit de la valeur par défaut).
Après avoir sélectionné toutes les opérations que vous souhaitez cibler, cliquez sur OK pour générer la classe de client WCF.
Le plug-in Add Adapter Service Reference ajoute deux fichiers à votre projet :
Fichier de code client WCF. Ce fichier contient la classe de client WCF et le code d’assistance générés pour les opérations que vous avez sélectionnées. La première fois que vous exécutez le plug-in Visual Studio Add Adapter Service, il génère ce fichier avec le nom par défaut SQLAdapterBindingClient.cs. Si vous l’exécutez à nouveau, le fichier suivant qu’il génère s’appelleRA SQLAdapterBindingClient1.cs. Le suffixe de nombre augmente de 1 pour chaque nouveau fichier que vous générez. Vous pouvez également modifier le préfixe par défaut SQLBinding en entrant un autre préfixe dans le champ Préfixe de nom de fichier du plug-in Visual Studio add adapter service reference avant de sélectionner OK pour générer le fichier.
App.config. Ce fichier contient une configuration de liaison et des configurations de point de terminaison client basées sur les sélections que vous avez effectuées lorsque vous avez configuré la connexion pour le plug-in Add Adapter Service Reference.
Important
Lors de l’utilisation du plug-in Add Adapter Service Reference, si vous ne spécifiez pas de valeur pour une propriété de liaison de type chaîne et dont la valeur par défaut est null, cette propriété de liaison ne sera pas disponible dans le fichier app.config. Vous devez ajouter manuellement la propriété de liaison et sa valeur dans le fichier app.config, si nécessaire.
Génération d’un contrat de service WCF à l’aide du plug-in Add Adapter Service Reference
Pour les opérations entrantes telles que l’interrogation de la base de données SQL Server ou la réception de notifications de la base de données, l’adaptateur SQL exécute une requête spécifiée par l’application cliente (en cas d’interrogation) ou inscrit une requête avec SQL Server (en cas de notification). Dans les deux scénarios, l’adaptateur envoie le message entrant de SQL Server base de données au consommateur. Dans ce cas, l’application consommatrice agit en tant que service et l’adaptateur SQL en tant que client. Vous devez donc implémenter un service WCF qui peut recevoir des opérations entrantes à partir de l’adaptateur. Pour ce faire, vous utilisez le plug-in Add Adapter Service Reference pour générer une interface .NET qui représente le contrat de service qui est mis en évidence par l’adaptateur pour les opérations entrantes. Cette interface .NET est également appelée contrat de service WCF. Vous implémentez ensuite cette interface pour créer le service WCF que vous pouvez utiliser pour recevoir les opérations entrantes.
Effectuez les étapes suivantes pour générer un contrat de service WCF à l’aide du plug-in Add Adapter Service Reference.
Pour générer un contrat de service WCF pour les opérations entrantes
Dans Visual Studio Explorateur de solutions, cliquez avec le bouton droit sur votre projet, puis cliquez sur Ajouter une référence du service d’adaptateur.
Une fois la boîte de dialogue Ajouter une référence de service d’adaptateur ouverte, suivez les étapes décrites dans Se connecter à SQL Server dans Visual Studio à l’aide du plug-in Add Adapter Service Reference pour vous connecter à la base de données SQL Server.
Important
Si vous générez un contrat de service WCF pour l’opération entrante TypedPolling , vous devez spécifier l’InboundID dans le cadre de l’URI de connexion et de la propriété de liaison PollingStatement .
Une fois connecté à la base de données SQL Server, sélectionnez Service (opérations entrantes) dans la liste déroulante Sélectionner un type de contrat.
Dans la zone Sélectionner une catégorie , cliquez sur le nœud racine (/), sélectionnez l’opération entrante dans la zone Catégories et opérations disponibles , puis cliquez sur Ajouter.
Pour générer le contrat de service WCF pour l’opération entrante, cliquez sur OK.
Le plug-in Add Adapter Service Reference ajoute trois fichiers à votre projet :
SqlAdapterBindingInterface.cs. Ce fichier contient le contrat de service WCF (interface) et le code d’assistance générés pour l’opération entrante.
SqlAdapterBindingService.cs. Ce fichier contient une classe qui implémente l’interface définie dans SqlAdapterBindingInterface.cs. Vous pouvez implémenter la logique métier qui traite les enregistrements retournés par l’opération entrante.
app.config. Ce fichier contient une configuration de liaison, des comportements de point de terminaison et une configuration du point de terminaison de service qui sont basés sur les sélections que vous avez effectuées lorsque vous avez configuré la liaison et la connexion pour le plug-in Add Adapter Service Reference.
Important
Lors de l’utilisation du plug-in Add Adapter Service Reference, si vous ne spécifiez pas de valeur pour une propriété de liaison de type chaîne et dont la valeur par défaut est null, cette propriété de liaison ne sera pas disponible dans le fichier app.config. Vous devez ajouter manuellement la propriété de liaison et sa valeur dans le fichier app.config, si nécessaire.
Génération d’une classe cliente WCF à l’aide de svcutil.exe
Vous pouvez utiliser svcutil.exe pour générer une classe de client WCF pour votre application. Vous devez configurer svcutil.exe pour l’utiliser avec l’adaptateur SQL.
Svcutil.exe génère la classe de client WCF dans un fichier de sortie avec un nom de fichier par défaut output.cs. Vous devez inclure manuellement ce fichier dans votre projet Visual Studio. Pour plus d’informations sur svcutil.exe, consultez ServiceModel Metadata Utility Tool (Svcutil.exe).
Voir aussi
Développer des applications SQL à l’aide du modèle de service WCF