CrmService.Create Method
.gif) |
Creates an instance of an entity.
Syntax
[Visual Basic]
Public Function Create(
ByVal entity As BusinessEntity
) As Guid
[C#]
public Guid Create(
BusinessEntity entity
);
[JScript]
public function Create(
entity : BusinessEntity
) : Guid;
Parameters
entity
Specifies an instance of a class derived from BusinessEntity of the type of entity to create.
Return Value
Returns a Guid type that contains the ID of the newly created entity.
Remarks
Use this method to create an instance of any Microsoft CRM entity that supports the Create message.
To perform this action, the caller must have the Create privilege for the entity type and access rights on the entity instance specified in the request class. The owner of the newly created instance should also have the Read privilege for the entity type.
Example
The following example demonstrates the use of the Create method.
// Set up the CRM service.
CrmService service = new CrmService();
service.Credentials = System.Net.CredentialCache.DefaultCredentials;
// Create the contact object.
contact contact = new contact();
// Create the properties for the contact object.
contact.firstname = "Jesper";
contact.lastname = "Aaberg";
contact.address1_line1 = "23 Market St.";
contact.address1_city = "Sammamish";
contact.address1_stateorprovince = "MT";
contact.address1_postalcode = "99999";
contact.donotbulkemail = new CrmBoolean();
contact.donotbulkemail.Value = true;
// Create the contact in Microsoft CRM.
Guid contactGuid = service.Create(contact);
[Visual Basic .NET]
' Set up the CRM service.
Dim service As New CrmService()
service.Credentials = System.Net.CredentialCache.DefaultCredentials
' Create the contact object.
Dim contact As New contact()
' Create the properties for the contact object.
contact.firstname = "Jesper"
contact.lastname = "Aaberg"
contact.address1_line1 = "23 Market St."
contact.address1_city = "Sammamish"
contact.address1_stateorprovince = "MT"
contact.address1_postalcode = "99999"
contact.donotbulkemail = New CrmBoolean()
contact.donotbulkemail.Value = True
' Create the contact in Microsoft CRM.
Dim contactGuid As Guid = service.Create(contact)
See Also