Verwenden der Entitätsklassen zum Erstellen, Aktualisieren und Löschen
Veröffentlicht: Januar 2017
Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
In Microsoft Dynamics 365 (online und lokal) können Sie die Klasse Entity verwenden, um Entitäten und Entitätsattribute zu erstellen, zu aktualisieren und zu löschen.
Erstellen, Aktualisieren und Löschen mithilfe von Entitätsklassen
Wenn Sie mit der Klasse Entity arbeiten und späte Bindung verwenden, arbeiten Sie mit dem Entitäts- und dem logischen Attributnamen. Dieses steht im Gegensatz zur frühen Bindung, wo Sie mit dem Entitäts- und Attributschemanamen arbeiten. Der logische Attributname besteht nur aus Kleinbuchstaben, während der Schemaattributname der Groß-/Kleinschreibung nach Pascal folgt.
Um eine neue Entität zu erstellen, erstellen Sie zuerst eine neue Instanz einer Entity-Klasse und übergeben ihr einen Entitätsnamen. Das folgende Codebeispiel zeigt, wie ein neuer Firmendatensatz erstellt wird.
// 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);
Im Beispiel wird ein neues Entitätsobjekt vom Typ "Firma" erstellt, Attribute werden gesetzt, und anschließend wird die IOrganizationService.Create-Methode aufgerufen, um den neuen Datensatz zu erstellen.
Um eine Entität zu aktualisieren, legen Sie einen Wert für das zu aktualisierende Attribut fest und rufen anschließend die IOrganizationService.Update-Methode auf. Das folgende Codebeispiel zeigt, wie ein Attribut für eine Firma aktualisiert wird.
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);
Um eine Entität zu löschen, können Sie die Schlüsselattributinformationen an die IOrganizationService.Delete-Methode übergeben. Das folgende Codebeispiel zeigt, wie die Delete-Methode verwendet wird.
_orgService.Delete("account", _accountId);
Siehe auch
Verwenden Sie die Entitätsklasse, um Zuordnungen zwischen verwandten Datensätzen hinzuzufügen oder zu aktualisieren
Verwenden Sie die spät gebunden Entitätsklasse in Code
Microsoft Dynamics 365
© 2017 Microsoft. Alle Rechte vorbehalten. Copyright