Configuration du service de données (WCF Data Services)

Avec Services de données WCF , vous pouvez créer des services de données qui exposent des flux Protocole OData (Open Data) . Les données contenues dans ces flux peuvent provenir de plusieurs sources de données. Services de données WCF utilise des fournisseurs de données pour exposer ces données comme un flux OData . Ces fournisseurs comprennent un fournisseur Entity Framework , un fournisseur de réflexion et un jeu d'interfaces de fournisseur de services de données personnalisé. L'implémentation de fournisseur définit le modèle de données du service. Pour plus d'informations, consultez Fournisseurs de services de données (WCF Data Services).

Dans Services de données WCF , un service de données est une classe qui hérite de la classe DataService , où le type du service de données est le conteneur d'entités du modèle de données. Ce conteneur d'entités a une ou plusieurs propriétés qui retournent un objet IQueryable utilisé pour accéder aux jeux d'entités dans le modèle de données.

Les comportements du service de données sont définis par les membres de la classe DataServiceConfiguration, et par les membres de la classe DataServiceBehavior, accessible depuis la propriété DataServiceBehavior de la classe DataServiceConfiguration. La classe DataServiceConfiguration est fournie à la méthode InitializeService implémentée par le service de données, comme dans l'implémentation suivante d'un service de données Northwind :

' This method is called only once to initialize service-wide policies.
Public Shared Sub InitializeService(ByVal config As DataServiceConfiguration)
    ' Set the access rules of feeds exposed by the data service, which is
    ' based on the requirements of client applications.
    config.SetEntitySetAccessRule("Customers", EntitySetRights.ReadSingle)
    config.SetEntitySetAccessRule("Employees", EntitySetRights.ReadSingle)
    config.SetEntitySetAccessRule("Orders", EntitySetRights.AllRead _
        And EntitySetRights.WriteAppend _
        And EntitySetRights.WriteMerge)
    config.SetEntitySetAccessRule("Order_Details", EntitySetRights.All)
    config.SetEntitySetAccessRule("Products", EntitySetRights.ReadMultiple)

    ' Set page size defaults for the data service.
    config.SetEntitySetPageSize("Orders", 20)
    config.SetEntitySetPageSize("Order_Details", 50)
    config.SetEntitySetPageSize("Products", 50)

    ' Paging requires v2 of the OData protocol.
    config.DataServiceBehavior.MaxProtocolVersion = _
        System.Data.Services.Common.DataServiceProtocolVersion.V2
End Sub

// This method is called only once to initialize service-wide policies.
public static void InitializeService(DataServiceConfiguration config)
{
    // Set the access rules of feeds exposed by the data service, which is
    // based on the requirements of client applications.
    config.SetEntitySetAccessRule("Customers", EntitySetRights.ReadSingle);
    config.SetEntitySetAccessRule("Employees", EntitySetRights.ReadSingle);
    config.SetEntitySetAccessRule("Orders", EntitySetRights.AllRead 
        & EntitySetRights.WriteAppend
        & EntitySetRights.WriteMerge);
    config.SetEntitySetAccessRule("Order_Details", EntitySetRights.All);
    config.SetEntitySetAccessRule("Products", EntitySetRights.ReadMultiple);

    // Set page size defaults for the data service.
    config.SetEntitySetPageSize("Orders", 20);
    config.SetEntitySetPageSize("Order_Details", 50);
    config.SetEntitySetPageSize("Products", 50);

    // Paging requires v2 of the OData protocol.
    config.DataServiceBehavior.MaxProtocolVersion =
        System.Data.Services.Common.DataServiceProtocolVersion.V2;
}

Paramètres de la configuration du service de données

La classe DataServiceConfiguration vous permet de spécifier les comportements de service de données suivants :

Spécifications minimales pour l'accès aux ressources

Le tableau suivant détaille les droits minimaux de jeu d'entités qui doivent être accordés pour exécuter une opération spécifique. Les exemples de chemin d'accès sont basés sur le service de données Northwind créé lorsque vous effectuez le démarrage rapide. Puisque l'énumération EntitySetRights et l'énumération ServiceOperationRights sont toutes deux définies à l'aide de l'objet FlagsAttribute, vous pouvez utiliser un opérateur OR logique pour spécifier plusieurs autorisations pour un jeu d'entités ou une opération unique. Pour plus d'informations, consultez Procédure : activer l'accès au service de données (WCF Data Services).

1 dans cet exemple, Address représente une propriété de type complexe de l'entité Customers qui a une propriété nommée StreetAddress. Le modèle utilisé par les services de données Northwind ne définit pas ce type complexe explicitement. Lorsque le modèle de données est défini à l'aide du fournisseur Entity Framework , vous pouvez utiliser les outils Entity Data Model pour définir un tel type complexe. Pour plus d'informations, consultez How to: Create and Modify Complex Types (Entity Data Model Tools).

2 cet URI est pris en charge lorsqu'une propriété qui retourne un objet BLOB (binary large object) est définie comme étant la ressource multimédia appartenant à une entité qui est une entrée de lien média, en l'occurrence Customers. Pour plus d'informations, consultez Fournisseurs de diffusion en continu (WCF Data Services).

Conditions requises pour le contrôle de version

Les comportements de configuration du service de données suivants nécessitent la version 2 du protocole OData ou les versions ultérieures.

• Prise en charge des demandes relatives au nombre de lignes.

• Prise en charge de l'option de requête $select pour la projection.

Pour plus d'informations, consultez Utilisation de plusieurs versions de WCF Data Services.

Voir aussi

Concepts

Hébergement du service de données (WCF Data Services)

Autres ressources

Définition de WCF Data Services