Share via


Create Operation

Creates a single record. The supplied record object is overwritten with the version that is created by the page.

Method Signature

void Create(ref Entity entity)

Parameters

Parameter Description
entity Type: Entity

A variable of a specific object type that represents the page.

Results

Result name Description
entity Type: Entity

A variable of a specific object type that represents the page. Contains the latest values that are present on the page after the record has been inserted into the table.

Faults

SOAP fault message Description
The [record name] already exists. Identification fields and values: [field]=[value] Indicates that the record insertion would violate key constraints.

Other faults are possible if they are generated by the C/AL code.

Usage Example

For a detailed code example, see Walkthrough: Registering and Using a Page Web Service (SOAP).

Customer cust = new Customer();  
cust.Name = "Customer Name";  
service.Create(ref cust);  

See Also

Basic Page Operations