{"title":"UpdateMultiple Operation","url":"https://jonas-paprotka.de/docs/dev-itpro/webservices/updatemultiple-operation/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/webservices/updatemultiple-operation, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/webservices/updatemultiple-operation","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","date":"2021-04-01","meta":{"topic":"article"},"outline":[{"level":2,"title":"Method Signature","slug":"method-signature","at":384,"chars":63},{"level":2,"title":"Parameters","slug":"parameters","at":447,"chars":150},{"level":2,"title":"Results","slug":"results","at":597,"chars":293},{"level":2,"title":"Faults","slug":"faults","at":890,"chars":852},{"level":2,"title":"Usage Example","slug":"usage-example","at":1742,"chars":560},{"level":2,"title":"Related information","slug":"related-information","at":2302,"chars":44}],"text":"Updates a set of records. The updated array of records is passed as a reference and is updated with the latest version.\n> NOTE\n> The UpdateMultiple operation attempts to update one field at a time. This can cause errors if the updated value in one field prevents another field's value from being valid. You can resolve this by deleting and inserting lines instead of updating fields.\n## Method Signature\n`void UpdateMultiple(ref Entity[] entity)`\n## Parameters\nParameter|Description\n*entity\\[\\]*|Type: An array of Entities.<br /><br /> An array of a specific object type that represents the page.\n## Results\nResult name|Description\n*entity\\[\\]*|Type: An array of Entities<br /><br /> An array of a specific object type that represents the page. Contains the latest values that are present on the page after the records have been updated by the business logic or another concurrent process.\n## Faults\nSOAP fault message|Description\nOther user has modified \\[*record name*\\].|Indicates that another user or process has modified the record after it has been retrieved for this update operation.\n\\[*record name*\\] \\[*field*\\] \\[*value*\\] does not exist.|Indicates that the record has been deleted by another user or process after it has been retrieved for this update operation.\nThe \\[*record name*\\] already exists. Identification fields and values: \\[*field*\\]=\\[*value*\\]|Indicates that the renaming of the record would violate key constraints.\nOther faults are possible if they are generated by the AL code.\nThe UpdateMultiple operation is executed as a single transaction unless the AL code explicitly commits the transaction. Either all or none of the records are updated provided that the application code does not explicitly call COMMIT.\n## Usage Example\nThe following example adds the string \"Updated\" to the name of the first 100 customer names that start with S.\n```c#\nList<Customer_Filter> filterArray = new List<Customer_Filter>();\nCustomer_Filter nameFilter = new Customer_Filter();\nnameFilter.Field = Customer_Fields.Name;\nnameFilter.Criteria = \"S*\";\nfilterArray.Add(nameFilter);\nCustomer[] custList = service.ReadMultiple(filterArray.ToArray(), null, 100);\nfor (int i = 0; i < custList.Length; i++)\n{\n  custList [i].Name = custList [i].Name + \" Updated\";\n}\nservice.Update(ref custList)\n```\n## Related information\nbasic-page-operations"}