Utilizzare la classe Entity per creare, aggiornare ed eliminare

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

In Microsoft Dynamics 365 (online e locale), è possibile utilizzare la classe Entity per creare, aggiornare ed eliminare le entità e gli attributi delle entità.

Creare, aggiornare ed eliminare tramite la classe Entity

Quando si utilizza la classe Entity e l'associazione tardiva, si utilizza il nome logico di attributo e di entità. Questo si contrappone all'associazione anticipata in cui si utilizza il nome di schema di attributo e di entità. Il nome logico di attributo è in sole lettere minuscole mentre per il nome di schema si utilizza la convenzione Pascal.

Per creare una nuova entità, è necessario innanzitutto creare una nuova istanza della classe Entity e assegnare un nome di entità. Nell'esempio di codice seguente viene illustrato come creare un nuovo record di account.

// 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);

Nell'esempio, viene creato un nuovo oggetto entità di tipo "account", vengono impostati gli attributi e viene chiamato il metodo IOrganizationService.Create per creare il nuovo record.

Per aggiornare un'entità, si imposta un valore per l'attributo da aggiornare e quindi viene chiamato il metodo IOrganizationService.Update. Nell'esempio seguente viene illustrato come aggiornare un attributo in un account.

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);

Per eliminare un'entità, è possibile passare le informazioni principali sull'attributo al metodo IOrganizationService.Delete. Nell'esempio di codice seguente viene illustrato come utilizzare il metodo Delete.

_orgService.Delete("account", _accountId);

Vedere anche

Utilizzare la classe Entity per aggiungere o aggiornare le associazioni tra record correlati
Utilizzare la classe di entità con associazione tardiva nel codice

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright