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

Artigo
05/11/2016

Cria um item externo com uma identidade específica e um objeto de OperationMode , associado a outro item externo s 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, _
    mode As OperationMode _
) As EntityInstanceReference
'Uso
Dim instance As IEntity
Dim fieldValues As IFieldValueDictionary
Dim assignedIdentity As Identity
Dim associatedInstances As AssociationEntityInstancesDictionary
Dim lsi As ILobSystemInstance
Dim mode As OperationMode
Dim returnValue As EntityInstanceReference

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

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

Parâmetros

fieldValues
Tipo: Microsoft.BusinessData.Runtime.IFieldValueDictionary

Os parâmetros do método Create .

assignedIdentity
Tipo: Microsoft.BusinessData.Runtime.Identity

A identidade que é atribuída à ocorrência.

associatedInstances
Tipo: Microsoft.BusinessData.Runtime.AssociationEntityInstancesDictionary

O que estão associadas a essa instância durante a criação de item externo.

lsi
Tipo: Microsoft.BusinessData.MetadataModel.ILobSystemInstance

A instância do sistema externo.

mode
Tipo: Microsoft.BusinessData.Runtime.OperationMode

O modo no qual deseja criar o item 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