Partager via

Vue d’ensemble du modèle de service WCF avec l’adaptateur SQL

  • Article

L’adaptateur Microsoft BizTalk pour SQL Server expose une opération SQL Server en tant que service WCF. Pour effectuer des opérations sur SQL Server artefacts, par exemple pour appeler une procédure stockée, vous appelez une opération sur l’adaptateur, qui, à son tour, effectue l’opération sur le SQL Server. Votre code agit donc en tant que client pour le service WCF présenté par l’adaptateur.

Dans le modèle de service Windows Communication Foundation (WCF), le contrat de service qui existe entre un client et un service est représenté sous la forme d’une interface .NET, et les opérations sont représentées sous forme de méthodes sur cette interface. L’adaptateur SQL et WCF fournissent des outils qui vous permettent de générer cette interface pour les opérations ciblées à partir des métadonnées exposées par l’adaptateur. Ces outils créent également une classe de client WCF qui peut être utilisée pour appeler les opérations exposées dans l’interface de service. Une application cliente peut appeler les méthodes de la classe de client WCF pour appeler des opérations sur l’adaptateur. Pour implémenter un service afin de recevoir des opérations entrantes à partir de l’adaptateur SQL, vous implémentez l’interface générée pour les opérations entrantes.

La section suivante explique comment utiliser le modèle de service WCF pour appeler des opérations avec un client WCF.

Appel des opérations sur le SQL Server avec un client WCF

Pour utiliser le modèle de service WCF afin d’appeler des opérations sur l’adaptateur SQL, vous devez d’abord générer une classe de client WCF pour les opérations cibles. Vous pouvez ensuite créer un instance de cette classe, un client WCF, et appeler ses méthodes pour effectuer ces opérations sur le système SQL Server. Cette section fournit une vue d’ensemble de l’apparence d’une application cliente d’adaptateur .NET classique. Des explications détaillées sur la façon d’effectuer différentes opérations sur la base de données SQL Server à l’aide de l’adaptateur sont fournies dans des rubriques spécifiques.

Pour appeler des opérations sur l’adaptateur SQL

  1. Générez une classe de client WCF et du code d’assistance. Utilisez le plug-in Visual Studio Add Adapter Service pour générer une classe de client WCF ciblée sur les artefacts de base de données SQL Server avec lesquels vous souhaitez travailler. Pour plus d’informations sur la génération d’un client WCF, consultez Générer un client WCF ou un contrat de service WCF pour SQL Server Artefacts.

  2. Créez un client WCF instance et configurez le client WCF. La configuration du client WCF implique de spécifier la liaison et l’adresse de point de terminaison (URI de connexion) que le client utilisera. Vous pouvez le faire impérativement dans le code ou de manière déclarative dans la configuration. Le code suivant crée un client WCF qui cible l’opération Select sur la table Employee dans une base de données SQL Server. Il définit également les informations d’identification de la base de données SQL Server. Le client WCF est initialisé à partir de la configuration.

    TableOp_dbo_EmployeeClient client = new TableOp_dbo_EmployeeClient("SqlAdapterBinding_TableOp_dbo_Employee"); //picking the binding and address from the app.config  

client.ClientCredentials.UserName.UserName = "myuser";  
client.ClientCredentials.UserName.Password = "mypassword";

    Notes

    Vous pouvez spécifier la liaison client et l’adresse de point de terminaison dans le code ou les déclarer dans le fichier de configuration app.config. L’extrait de code précédent utilise ce dernier. Pour plus d’informations sur l’utilisation de l’une ou l’autre des approches, consultez Configurer une liaison cliente pour l’adaptateur SQL.

  3. Ouvrez le client WCF.

    client.Open();

  4. Appelez des méthodes sur le client WCF créé à l’étape précédente pour effectuer une opération Select sur la base de données SQL Server. Le code suivant appelle la méthode Select du client WCF pour appeler l’instruction SELECT sur une table de base de données SQL Server.

    client.Select("*", "where [Name] = ‘John Smith’");

  5. Fermez le client WCF.

    client.Close();

Voir aussi

Développer des applications SQL à l’aide du modèle de service WCF