Service de données WCF

Article
10/04/2023

WCF Data Services vous permet de créer et d’utiliser des services OData (Open Data Protocol) dans votre application. OData expose vos données en tant que ressources adressables par les URI, ce qui vous permet d’accéder aux données et de les modifier à l’aide de la sémantique rest (representational state transfer), en particulier les verbes HTTP standard de GET, PUT, POST et DELETE. Pour plus d’informations, consultez ASP.NET Dynamic Data Content Map (https://go.microsoft.com/fwlink/?LinkId=199029), WCF Data Services (https://go.microsoft.com/fwlink/?LinkId=199030) et A Developer’s Guide to the WCF REST Starter Kit (https://go.microsoft.com/fwlink/?LinkId=199031).

Cette rubrique contient les sections suivantes :

Ajout du service de données WCF

Cette procédure pas à pas s’appuie sur la procédure pas à pas de Dynamic Data Web dans Dynamic Data Web. Procédez comme suit pour créer le service de données WCF à l’aide d’un modèle Visual Studio.

À partir du Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet DynamicData. La boîte de dialogue Ajouter un nouvel élément s'affiche.
Sous Modèles installés, dans le volet gauche, sélectionnez Visual C#.
Dans le volet central, sélectionnez Service de données WCF.
Dans la zone Nom , entrez un nom pour le service de données. Par exemple, entrez le nom WcfDataServiceDB2.svc , puis cliquez sur Ajouter.

Important

Vous devez activer explicitement l’accès aux ressources pour pouvoir accéder aux ressources ou aux associations. Pour activer l’accès en lecture et en écriture à toutes les ressources de l’Entity Data Model associé au service, recherchez la méthode InitializeService et assurez-vous qu’elle correspond à ce qui est indiqué dans l’exemple.

Configuration du service de données WCF

Dans le fichier WcfDataServiceDB2.cs, remplacez les commentaires /* TODO: put your data source class name here */ de code par SAMPLEModel.SAMPLEEntities.
```
public class WcfDataServiceDB2 : DataService<SAMPLEModel.SAMPLEEntities>
```
L’étape suivante consiste à autoriser l’accès aux entités exposées par le service de données. Par défaut, l’accès à tous les jeux d’entités n’est pas autorisé. L’accès doit être autorisé pour chaque ensemble d’entités.

Dans le fichier WcfDataServiceDB2.cs, supprimez les marques de commentaire du code contenant la configuration. SetEntitySetAccessRule. Remplacez MyEntitySet par un astérisque (*), remplacez AllRead par All.

using System;
using System.Data.Services;
using System.Data.Services.Common;
using System.Collections.Generic;
using System.Linq;
using System.ServiceModel.Web;

public class WcfDataServiceDB2 : DataService<SAMPLEModel.SAMPLEEntities>
{
    // This method is called only once to initialize service-wide policies.
    public static void InitializeService(DataServiceConfiguration config)
    {
        // TODO: set rules to indicate which entity sets and service operations are visible, updatable, etc.
        // Examples:
        config.SetEntitySetAccessRule("*", EntitySetRights.All);
        // config.SetServiceOperationAccessRule("MyServiceOperation", ServiceOperationRights.All);
        config.DataServiceBehavior.MaxProtocolVersion = DataServiceProtocolVersion.V2;
    }
}

Dans le menu Fichier , cliquez sur Enregistrer WcfDataServiceDB2.cs.
Dans Explorateur de solutions, cliquez avec le bouton droit sur WcfDataServiceDB2.svc, puis sélectionnez Définir comme page de démarrage.

Configurer des Explorer Internet à utiliser avec le service de données WCF

Suivez ces étapes pour configurer Internet Explorer pour afficher le service de données WCF en tant que flux RSS.

Dans le menu Outils , cliquez sur Options Internet, puis sur Contenu.
Le volet Contenu de la boîte de dialogue Options Internet s’affiche.
Cliquez sur Paramètres pour les flux et les tranches web. Désactivez la zone Activer le mode lecture du flux case activée, puis cliquez sur OK.

Test du service de données WCF

Procédez comme suit pour tester le service de données WCF que vous avez créé.

Dans le menu Déboguer , cliquez sur Démarrer le débogage. Si vous êtes invité à ne pas activer le débogage, cliquez sur OK. Internet Explorer affiche le service de données WCF.

OData expose les données sous forme de ressources adressables par des URI. Les chemins d'accès aux ressources sont construits selon les conventions de relation d'entité de l'Entity Data Model. Dans ce modèle, les entités représentent des unités opérationnelles de données dans un domaine d’application, par exemple DEPARTMENTs et EMPLOYEEs.
Dans Internet Explorer, entrez un URI pour retourner tous les enregistrements d’une table DB2 via le service de données.

Dans OData, vous traitez les ressources d’entité comme un jeu d’entités qui contient des instances de types d’entités. Par exemple, l’URI http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/Orders retourne toutes les commandes du service de données Northwind qui sont liées au client avec une valeur CustomerID d’ALFKI.
```
http://localhost:36651/DynamicData/WcfDataServiceDB2.svc/DEPARTMENTs
```
Fermez le navigateur lorsque vous avez terminé d’afficher les enregistrements de la base de données.

Voir aussi

Dynamic Data Web Entity Framework