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

Crea un elemento externo, con un objeto determinado OperationMode , asociado a otros elementos externos y establece todos los campos de tipo de contenido externo en los valores especificados con una actualización.

Espacio de nombres:  Microsoft.BusinessData.MetadataModel
Ensamblado:  Microsoft.BusinessData (en Microsoft.BusinessData.dll)

Sintaxis

'Declaración
Function CreateWithFields ( _
    fieldValues As IFieldValueDictionary, _
    associatedInstances As AssociationEntityInstancesDictionary, _
    lsi As ILobSystemInstance, _
    mode As OperationMode _
) As EntityInstanceReference
'Uso
Dim instance As IEntity
Dim fieldValues As IFieldValueDictionary
Dim associatedInstances As AssociationEntityInstancesDictionary
Dim lsi As ILobSystemInstance
Dim mode As OperationMode
Dim returnValue As EntityInstanceReference

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

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

Parámetros

• fieldValues
  Tipo: Microsoft.BusinessData.Runtime.IFieldValueDictionary

  Los parámetros del método Create .

• associatedInstances
  Tipo: Microsoft.BusinessData.Runtime.AssociationEntityInstancesDictionary

  Las instancias de tipo de contenido externo que están asociadas a esta instancia durante la creación.

• lsi
  Tipo: Microsoft.BusinessData.MetadataModel.ILobSystemInstance

  La instancia de sistema externo.

• mode
  Tipo: Microsoft.BusinessData.Runtime.OperationMode

  El modo en que se va a crear el elemento externo.

Valor devuelto

Tipo: Microsoft.BusinessData.Runtime.EntityInstanceReference
Una referencia a la nueva instancia.

Comentarios

Puede usar este método para crear un elemento externo especificando los valores de los campos del elemento externo creado. Si el Create MethodInstance acepta todos los campos que se proporcionan, BDC simplemente llamará la Create MethodInstance. En caso contrario, BDC también llamará la Update MethodInstance en el elemento externo creado para establecer los valores especificados para los campos restantes. Si la operación de Create es correcta, y se produce un error en la operación de actualización consecutivas, esta operación producirá una PartialCreateException, que contendrá la Identity de la instancia creada.

El método devuelve el EntityInstanceReference al elemento externo que se creó. La instancia de IFieldValueDictionary proporcionada como una entrada a este método debe crearse desde View que corresponde a un MethodInstance de tipo SpecificFinder, que se obtienen a través del método GetCreatorView(String) .

Puede especificar el modo de funcionamiento para este método. Para obtener más información sobre cómo usar los modos de funcionamiento, vea OperationMode.

Vinculan al almacén de metadatos que se obtienen de instancias de objetos en el modelo de objetos de conectividad a datos empresariales. Usar casos en los que están vinculadas a un repositorio de metadatos con las instancias de otro almacén de metadatos provocará daños en los datos y otros comportamientos inesperados. Para obtener más información, vea DatabaseBackedMetadataCatalog, FileBackedMetadataCatalogy RemoteSharedFileBackedMetadataCatalog.

Vea también

Referencia

interfaz IEntity

Miembros IEntity

Sobrecarga CreateWithFields

Espacio de nombres Microsoft.BusinessData.MetadataModel

Create(IFieldValueDictionary, AssociationEntityInstancesDictionary, ILobSystemInstance)