IEntity.CreateWithFields 方法 (IFieldValueDictionary, Identity, ILobSystemInstance)

建立外部項目與指定的身分識別，並設定外部內容類型的所有欄位的更新後使用指定的值。

命名空間:  Microsoft.BusinessData.MetadataModel
組件：  Microsoft.BusinessData (在 Microsoft.BusinessData.dll 中)

語法

'宣告
Function CreateWithFields ( _
    fieldValues As IFieldValueDictionary, _
    assignedIdentity As Identity, _
    lsi As ILobSystemInstance _
) As EntityInstanceReference
'用途
Dim instance As IEntity
Dim fieldValues As IFieldValueDictionary
Dim assignedIdentity As Identity
Dim lsi As ILobSystemInstance
Dim returnValue As EntityInstanceReference

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

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

參數

• fieldValues
  類型：Microsoft.BusinessData.Runtime.IFieldValueDictionary

  Create方法的參數。

• assignedIdentity
  類型：Microsoft.BusinessData.Runtime.Identity

  指派給執行個體的身分識別。

• lsi
  類型：Microsoft.BusinessData.MetadataModel.ILobSystemInstance

  外部系統執行個體。

傳回值

類型：Microsoft.BusinessData.Runtime.EntityInstanceReference
新的執行個體的參考。

備註

若要建立外部項目指定的建立外部項目欄位的值，您可以使用這個方法。如果Create MethodInstance接受所提供的所有欄位， BDC只會Create MethodInstance叫用。否則， BDC會也叫用Update MethodInstance上建立外部項目，若要設定的剩餘的欄位指定的值。如果Create作業是成功，且連續的更新失敗，這項作業會擲回PartialCreateException，其中會包含Identity建立的執行個體。

這個方法會傳回EntityInstanceReference所建立的外部項目。從對應到的類型SpecificFinder，透過GetCreatorView(String)方法取得MethodInstanceView建立做為輸入這個方法所提供的IFieldValueDictionary執行個體。

這種方式可以指定作業的模式。如需有關如何使用作業模式的詳細資訊，請參閱OperationMode。

Business Data Connectivity 物件模型中的物件的執行個體被與他們從取得中繼資料儲存區。使用連結至一個執行個體的中繼資料儲存區中，從另一個中繼資料儲存區的執行個體，會造成資料損毀及其他非預期的行為。如需詳細資訊，請參閱DatabaseBackedMetadataCatalog、 FileBackedMetadataCatalog，與RemoteSharedFileBackedMetadataCatalog。

請參閱

參照

IEntity 介面

IEntity 成員

CreateWithFields 多載

Microsoft.BusinessData.MetadataModel 命名空間

Create(IFieldValueDictionary, Identity, ILobSystemInstance)