CreateMultiple Operation
Creates a set of records. The supplied record object is overwritten with the version that is created by the page.
Method Signature
void CreateMultiple(ref Entity[] entity)
Parameters
| Parameter | Description |
|---|---|
| entity[] | Type: An array of Entities An array of a specific object type that represents the page. |
Results
| Result name | Description |
|---|---|
| entity[] | Type: An array of Entities 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 inserted into the table. |
Faults
| SOAP fault message | Description |
|---|---|
| The [record name] already exists. Identification fields and values: [field]=[value] | Indicates that the insertion of at least one of the records would violate key constraints. |
Other faults are possible if they are generated by the C/AL code.
The CreateMultiple operation is executed as a single transaction unless the C/AL code explicitly commits the transaction. Either all or none of the records are inserted unless the application code does not explicitly call COMMIT.
Usage Example
Customer[] custArray = new Customer[3];
for (int i = 0; i < custArray.Length; i++)
{
custArray[i] = new Customer();
custArray[i].Name = "Customer Name " + i.ToString();
}
service.CreateMultiple(ref custArray);