OrganizationService.Update Method (Entity)

  • Article

 

Applies To: Dynamics CRM 2015

Updates an existing record. (Developer Extensions)

Namespace:   Microsoft.Xrm.Client.Services
Assembly:  Microsoft.Xrm.Client (in Microsoft.Xrm.Client.dll)

Syntax

public virtual void Update(
    Entity entity
)

public:
virtual void Update(
    Entity^ entity
)

abstract Update : 
        entity:Entity -> unit
override Update : 
        entity:Entity -> unit

Public Overridable Sub Update (
    entity As Entity
)

Parameters

  • entity
    Type: Microsoft.Xrm.Sdk.Entity

    An entity instance that has one or more properties set to be updated in the record.

Implements

IOrganizationService.Update(Entity)

Remarks

This is a wrapper for the IOrganizationService. Update Method.

Message Availability

 This message works regardless whether the caller is connected to the server or offline.

Not all entity types support this message offline. See Supported Entities later in this topic.

Privileges and Access Rights

To perform this action, the caller must have privileges on the entity and access rights on the record specified in the Update parameter.. For a list of the required privileges, see Update message privileges.

Notes for Callers

If the entity instance includes properties that are not valid for update, they are ignored. You can find this information in the metadata for your organization. See the preceding metadata browser information.

You can use this method to update any record of an entity that supports the Update message, including custom entities.

For more information about the exceptions that can be thrown when this method is called, see Handle exceptions in your code.

Supported Entities

The following table shows the default entities that support this message. For the listed entities of this message, the Availability column shows Server if the caller must be connected to the server and shows Both if the caller can be either connected to, or disconnected from, the server.

See Also

OrganizationService Class
Microsoft.Xrm.Client.Services Namespace
Developer extensions context object model (Dynamics CRM 2015)
Developer extensions for Microsoft Dynamics CRM 2015

Return to top

© 2017 Microsoft. All rights reserved. Copyright