IEntity.CreateWithFields método (IFieldValueDictionary, Identity, AssociationEntityInstancesDictionary, ILobSystemInstance)

Artigo
05/11/2016

Cria um item externo com uma identidade específica, associada a outros itens externos e define todos os campos do tipo de conteúdo externo para os valores fornecidos com uma atualização.

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

Sintaxe

'Declaração
Function CreateWithFields ( _
    fieldValues As IFieldValueDictionary, _
    assignedIdentity As Identity, _
    associatedInstances As AssociationEntityInstancesDictionary, _
    lsi As ILobSystemInstance _
) As EntityInstanceReference
'Uso
Dim instance As IEntity
Dim fieldValues As IFieldValueDictionary
Dim assignedIdentity As Identity
Dim associatedInstances As AssociationEntityInstancesDictionary
Dim lsi As ILobSystemInstance
Dim returnValue As EntityInstanceReference

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

EntityInstanceReference CreateWithFields(
    IFieldValueDictionary fieldValues,
    Identity assignedIdentity,
    AssociationEntityInstancesDictionary associatedInstances,
    ILobSystemInstance lsi
)

Parâmetros

fieldValues
Tipo: Microsoft.BusinessData.Runtime.IFieldValueDictionary

Os parâmetros do método Create .

assignedIdentity
Tipo: Microsoft.BusinessData.Runtime.Identity

A identidade a ser atribuído à instância.

associatedInstances
Tipo: Microsoft.BusinessData.Runtime.AssociationEntityInstancesDictionary

Os itens externos que estão associados essa instância durante a criação.

lsi
Tipo: Microsoft.BusinessData.MetadataModel.ILobSystemInstance

A instância do sistema externo.

Valor retornado

Tipo: Microsoft.BusinessData.Runtime.EntityInstanceReference
Uma referência à instância recém-criado.

Comentários

Você pode usar esse método para criar um item externo, especificando os valores dos campos do item externo criado. Se o Create MethodInstance aceita todos os campos que são fornecidos, BDC apenas chamará o Create MethodInstance. Caso contrário, BDC também irá chamar o Update MethodInstance no item externo criado para definir os valores especificados para os campos restantes. Se a operação de Create for bem-sucedida, e a operação de atualização resultante falhar, essa operação irá acionar um PartialCreateException, que conterá o Identity da instância criada.

O método retorna o EntityInstanceReference no item externo que foi criado. A instância de IFieldValueDictionary fornecida como entrada para este método deve ser criada de uma View que corresponde a um MethodInstance do tipo SpecificFinder, obtidas por meio do método GetCreatorView(String) .

O modo de operação pode ser especificado para este método. Para obter mais informações sobre como usar os modos de operação, consulte OperationMode.

Instâncias de objetos do modelo de objeto de conectividade de dados corporativos estão vinculadas no repositório de metadados que eles são obtidos. Usando instâncias vinculadas a um repositório de metadados com as instâncias do repositório de metadados outro causará corrupção de dados e outro comportamento inesperado. Para obter mais informações, consulte DatabaseBackedMetadataCatalog, FileBackedMetadataCataloge RemoteSharedFileBackedMetadataCatalog.

Ver também

Referência

IEntity interface

IEntity membros

CreateWithFields em sobrecarga

Microsoft.BusinessData.MetadataModel namespace

Create(IFieldValueDictionary, Identity, AssociationEntityInstancesDictionary, ILobSystemInstance)

Compartilhar via