Utiliser la classe d’entité pour la création, la mise à jour et la suppression

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Dans Mise à jour de Microsoft Dynamics CRM 2015 et de Microsoft Dynamics CRM Online 2015, vous pouvez utiliser la classe Entity pour créer, mettre à jour et supprimer des entités et des attributs d’entité.

Créer, mettre à jour et supprimer à l’aide de la classe d’entité

Lorsque vous utilisez la classe Entity et la liaison tardive, utilisez l’entité et le nom de l’attribut logique. Ceci diffère de la liaison anticipée, pour laquelle vous utilisez l’entité et le nom de schéma de l’attribut. Le nom de l’attribut logique est en lettres minuscules, tandis que le nom de l attribut de schéma utilise la casse Pascal.

Pour créer une entité, vous devrez tout d’abord créer une instance de la classe Entity et lui envoyer un nom d’entité. L’exemple de code suivant montre comment créer un enregistrement de compte.

// Instantiate an account object.
Entity account = new Entity("account");

// Set the required attributes. For account, only the name is required. 
// See the metadata to determine 
// which attributes must be set for each entity.
account["name"] = "Fourth Coffee";

// Create an account record named Fourth Coffee.
_accountId = _orgService.Create(account);

Dans l’exemple, un nouvel objet d’entité de type « compte » est créé, les attributs sont définis, puis la méthode IOrganizationService.Create est appelée pour créer le nouvel enregistrement.

Pour mettre à jour une entité, définissez une valeur pour l’attribut à mettre à jour, puis appelez la méthode IOrganizationService.Update. L’exemple de code suivant montre comment mettre à jour un attribut dans un compte.

Entity account = new Entity("account");
// Create a column set to define which attributes should be retrieved.
ColumnSet attributes = new ColumnSet(new string[] { "name", "ownerid" }); 

// Retrieve the account and its name and ownerid attributes.
account = _orgService.Retrieve(account.LogicalName, _accountId, attributes);

// Update the postal code attribute.
account["address1_postalcode"] = "98052";

// Update the account.
_orgService.Update(account);

Pour supprimer une entité, passez les informations d’attribut clés pour la méthode IOrganizationService.Delete. L’exemple de code suivant montre comment utiliser la méthode Delete.

_orgService.Delete("account", _accountId);

Voir aussi

Utiliser la classe Entity pour ajouter ou mettre à jour les associations entre les enregistrements associés
Utiliser la classe d’entité à liaison tardive dans le code

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