IEntity.Create Method (IFieldValueDictionary, Identity, AssociationEntityInstancesDictionary, ILobSystemInstance)

Creates an external item.

Namespace:  Microsoft.BusinessData.MetadataModel
Assembly:  Microsoft.BusinessData (in Microsoft.BusinessData.dll)

Syntax

'Declaration
Function Create ( _
    fieldValues As IFieldValueDictionary, _
    assignedIdentity As Identity, _
    associatedInstances As AssociationEntityInstancesDictionary, _
    lsi As ILobSystemInstance _
) As Identity
'Usage
Dim instance As IEntity
Dim fieldValues As IFieldValueDictionary
Dim assignedIdentity As Identity
Dim associatedInstances As AssociationEntityInstancesDictionary
Dim lsi As ILobSystemInstance
Dim returnValue As Identity

returnValue = instance.Create(fieldValues, _
    assignedIdentity, associatedInstances, _
    lsi)

Identity Create(
    IFieldValueDictionary fieldValues,
    Identity assignedIdentity,
    AssociationEntityInstancesDictionary associatedInstances,
    ILobSystemInstance lsi
)

Parameters

• fieldValues
  Type: Microsoft.BusinessData.Runtime.IFieldValueDictionary

  The parameters of the Create method.

• assignedIdentity
  Type: Microsoft.BusinessData.Runtime.Identity

  The identity that is assigned to the instance.

• associatedInstances
  Type: Microsoft.BusinessData.Runtime.AssociationEntityInstancesDictionary

  The external items that are associated with this instance during creation.

• lsi
  Type: Microsoft.BusinessData.MetadataModel.ILobSystemInstance

  LobSystem instance.

Return Value

Type: Microsoft.BusinessData.Runtime.Identity
The identity of the created external item.

Remarks

You can use this method to create external items on the external system by specifying the values required for creation. The values do not necessarily correspond to fields of an external item. The method returns the Identity corresponding to the external item that was created. The IFieldValueDictionary instance provided as an input to this method should be created from a View that corresponds to a MethodInstance of type Creator.

Instances of objects in the Business Data Connectivity object model are tied to the Metadata Store they are obtained from. Using instances tied to one Metadata Store with the instances from another Metadata Store will cause data corruption and other unexpected behavior. For more information, see DatabaseBackedMetadataCatalog, FileBackedMetadataCatalog, and RemoteSharedFileBackedMetadataCatalog.

See Also

Reference

IEntity Interface

IEntity Members

Create Overload

Microsoft.BusinessData.MetadataModel Namespace

CreateWithFields(IFieldValueDictionary, Identity, AssociationEntityInstancesDictionary, ILobSystemInstance)