Conventions d’affectation de noms pour les entités et attributs

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Dans Microsoft Dynamics 365, la méthode de programmation que vous utilisez pour accéder aux données détermine la convention d’affectation de noms que vous utilisez.

Lorsque vous utilisez les classes fortement typées générées par l’outil de génération de code (CrmSvcUtil.exe) ou lorsque vous utilisez la classe OrganizationServiceContext, vous effectuez une programmation à liaison anticipée. Avec la programmation à liaison anticipée, vous utilisez le nom de schéma d’une entité ou d’un attribut. Les noms de schémas sont définis dans les propriétés Microsoft.Xrm.Sdk.Metadata.EntityMetadata.SchemaName et Microsoft.Xrm.Sdk.Metadata.AttributeMetadata.SchemaName.

L’exemple de code suivant illustre la liaison anticipée et utilise des noms de schémas.

// Create new account using early binding and a context object.
AWCServiceContext context = new AWCServiceContext(_serviceProxy);
Account account = new Account()  
{
  Name = "Contoso Services Extensions",
         EMailAddress1 = "contoso-Ext@contoso.com"
};

// Create an account record.context.AddToAccountSet(account);
context.SaveChanges();

Lorsque vous utilisez la classe Entity, vous effectuez une programmation à liaison tardive. Avec la programmation à liaison tardive, vous utilisez le nom logique d’une entité ou d’un attribut. Les noms logiques sont définis dans les propriétés Microsoft.Xrm.Sdk.Metadata.EntityMetadata.LogicalName et Microsoft.Xrm.Sdk.Metadata.AttributeMetadata.LogicalName.

L’exemple de code suivant illustre la liaison tardive et utilise des noms logiques.

//Create new account using late binding and the Entity class.
Entity accountentity = new Entity("account");
accountentity["name"] = "Contoso Services Extensions";
accountentity["emailaddress1"] = "contoso-Ext@contoso.com";

// Create an account record.
_accountId =_serviceProxy.Create(accountentity);

Pour rechercher les noms logiques et de schémas pour chaque entité, consultez les métadonnées de chaque entité.Pour afficher les métadonnées d'entité pour votre organisation, installez la solution Navigateur de métadonnées décrite dans l'article Parcourir les métadonnées de votre organisation. Vous pouvez également afficher les métadonnées d'une organisation non personnalisée dans un fichier Excel appelé EntityMetadata.xlsx dans le dossier de niveau supérieur du téléchargement du Kit de développement logiciel (SDK). Le fichier des classes fortement typées générées indique également les noms logiques et de schémas pour chaque entité et attribut.

Voir aussi

Utilisation des services Microsoft Dynamics CRM 2015 dans le code
Assemblys inclus dans le Kit de développement logiciel (SDK) Microsoft Dynamics CRM 2015
Utiliser les classes d’entité à liaison anticipée dans le code
Utiliser la classe d’entité à liaison tardive dans le code
Présentation des attributs d'entité dans Microsoft Dynamics CRM 2015

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