Générer du code avec les extensions de l’outil de génération de code (Dynamics CRM 2015)

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Les Extensions développeur pour Mise à jour de Microsoft Dynamics CRM 2015 et de Microsoft Dynamics CRM Online 2015 fournissent une bibliothèque d’extensions pour l’outil de génération de code CrmSvcUtil.exe utilisé pour générer une classe de contexte de données et des objets de transfert de données (DTO) pour toutes les entités Microsoft Dynamics 365. Ce mécanisme suit le même modèle de conception que celui que SqlMetal implémente dans l’infrastructure d’entité. La classe de contexte de données est responsable de toutes les opérations de données et fournit les interfaces IQueryable pour toutes les entités dans Microsoft Dynamics 365. Vous pouvez extraire les données en exécutant une requête LINQ sur les propriétés du groupes d’entités IQueryable. Vous pouvez modifier les données en utilisant les méthodes AddObject, DeleteObject, UpdateObject et SaveChanges.

L’extension Microsoft.Xrm.Client.CodeGeneration pour l’outil de génération de code CrmSvcUtil.exe fournit les fonctionnalités suivantes :

• Génère des classes d’entité statiquement typées.

• Génère des classes de relation plusieurs-à-plusieurs.

• Génère des noms de classe et des noms de propriété basés sur les noms de schéma Microsoft Dynamics 365.

• Génère une classe de contexte de données compatible WCF Data Services (Astoria/OData) pour gérer les entités.

Contenu de la rubrique

Classes d’entité

Classes de contexte de données

Classes d’entité

Les classes d’entité générées par l’outil de génération de code fournissent les fonctionnalités suivantes :

• Prise en charge des attributs d’annotation WCF Data Services (Astoria/OData).

• Accesseurs d’attributs d’entité fortement typés, qui autorisent ce qui suit :

  • Mappage de types de données Microsoft Dynamics 365 à des types de données CLR standard.

  • Accesseurs des relations plusieurs-à-un notamment :

    • Chargement différé de l’entité associée.

    • Accesseurs des ID de clés étrangères.

  • Accesseurs des relations plusieurs-à-plusieurs, qui fournissent le chargement différé du jeu d’entités associé.

Classes de contexte de données

Les classes de contexte de données générées par CrmSvcUtil.exe avec l’extension Microsoft.Xrm.Client.CodeGeneration utilisent les interfaces IUpdatable et IExpandProvider de WCF Data Services suite à l’héritage de la classe CrmOrganizationServiceContext. Pour plus d’informations, voir la documentation .NET suivante : Interface IUpdatable et Interface IExpandProvider. Ces interfaces comprennent les fonctionnalités suivantes :

• Prise en charge des opérations de lecture, création, mise à jour et suppression pour la gestion des entités.

• Prise en charge des opérations de définition de lien, d’ajout de lien et de suppression de lien pour gérer les relations (1 à N, N à 1 et N à N).

• Prise en charge de DataServiceHostFactory pour exposer les services Web et les services REST.

• Apport d’un fournisseur de requêtes LINQ pour les requêtes typées statiquement ou dynamiquement.

• Les requêtes dynamiques ne nécessitent pas de génération de code.

• Gestion de la mise en cache en arrière-plan.

Une classe de contexte unique est générée pour fournir des accesseurs de jeu d’entités typés statiquement. En outre, plusieurs sous-classes sont générées pour fournir des fonctionnalités de portail plus complètes utilisant les fonctionnalités de requête d’intercepteur de modification de WCF Data Services.

Voir aussi

AddObject
DeleteObject
UpdateObject
SaveChanges
Extensions développeur pour Microsoft Dynamics CRM 2015
Modèle d’objet de contexte des extensions développeur (Dynamics CRM 2015)
Utilisation et paramètres de ligne de commande de l’extension CrmSvcUtil.exe (Dynamics CRM 2015)
Utiliser les fichiers générés par classe

© 2017 Microsoft. Tous droits réservés. Copyright