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

Artigo
05/11/2016

Cria um item externo com uma identidade atribuída e um objeto específico OperationMode 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, _
    lsi As ILobSystemInstance, _
    mode As OperationMode _
) As EntityInstanceReference
'Uso
Dim instance As IEntity
Dim fieldValues As IFieldValueDictionary
Dim assignedIdentity As Identity
Dim lsi As ILobSystemInstance
Dim mode As OperationMode
Dim returnValue As EntityInstanceReference

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

EntityInstanceReference CreateWithFields(
    IFieldValueDictionary fieldValues,
    Identity assignedIdentity,
    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.

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 para a nova instância.

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, ILobSystemInstance)

Compartilhar via