Génération de classes de service de données client (WCF Data Services)
Un service de données qui implémente le protocole Protocole OData (Open Data) peut retourner un document des métadonnées du service qui décrit le modèle de données exposé par le flux OData. Pour plus d'informations, consultez OData : document des métadonnées de service. Vous pouvez utiliser la boîte de dialogue Ajouter une référence de service dans Visual Studio pour ajouter une référence à un service basé sur OData. Lorsque vous utilisez cet outil pour ajouter une référence aux métadonnées retournées par un flux OData dans un projet client, il effectue les actions suivantes :
Demande le document de métadonnées du service de données et interprète les métadonnées retournées.
Notes
Les métadonnées retournées sont stockées dans le projet client sous forme de fichier .edmx.Ce fichier .edmx ne peut pas s'ouvrir à l'aide d'Entity Data Model Designer parce qu'il n'a pas le même format que les fichiers .edmx utilisés par Entity Framework.Vous pouvez consulter ce fichier de métadonnées à l'aide de l'éditeur XML ou d'un éditeur de texte.Pour plus d'informations, consultez la spécification [MC-EDMX]: Entity Data Model for Data Services Packaging Format (en anglais).
Génère une représentation du service comme une classe de conteneur d'entités qui hérite de DataServiceContext. Cette classe de conteneur d'entités générée ressemble au conteneur d'entités que génèrent les outils Entity Data Model. Pour plus d'informations, voir Object Services Overview (Entity Framework).
Génère des classes de données pour les types de modèles de données découverts dans les métadonnées de service.
Ajoute une référence à l'assembly Microsoft.Data.Services.Client.dll au projet.
Notes
Lors de l'installation de la version 5.0 d'Services de données WCF, l'outil Ajouter une référence de service ajoute automatiquement une référence à cette nouvelle version de la bibliothèque cliente au lieu d'ajouter une référence à la version System.Data.Services.Client.dll incluse dans .NET Framework.Si, pour une raison ou pour une autre, vous devez utiliser la précédente version du client Services de données WCF, vous devez alors ajouter manuellement une référence à la version .NET Framework de cette bibliothèque.Pour plus d'informations, consultez Procédure : générer manuellement des classes de service de données client (WCF Data Services).
Pour plus d'informations, consultez Procédure : ajouter une référence de service de données (WCF Data Services).
Les classes de service de données client peuvent également être générées en utilisant l'outil DataSvcUtil.exe à l'invite de commandes. Pour plus d'informations, consultez Procédure : générer manuellement des classes de service de données client (WCF Data Services).
Mappage de type de données client
Lorsque vous utilisez la boîte de dialogue Ajouter une référence de service dans Visual Studio ou l'outil DataSvcUtil.exe pour générer des classes de données clientes basées sur un flux OData, les types de données .NET Framework sont mappés aux types primitifs du modèle de données comme suit :
Type de modèle de données |
Types de données .NET Framework |
---|---|
Edm.Binary |
Byte[] |
Edm.Boolean |
|
Edm.Byte |
|
Edm.DateTime |
|
Edm.Decimal |
|
Edm.Double |
|
Edm.Guid |
|
Edm.Int16 |
|
Edm.Int32 |
|
Edm.Int64 |
|
Edm.SByte |
|
Edm.Single |
|
Edm.String |
Pour plus d'informations, consultez OData : types de données primitifs.
Voir aussi
Concepts
Démarrage rapide (WCF Data Services)