IEntity.CreateWithFields - Méthode (IFieldValueDictionary, Identity, AssociationEntityInstancesDictionary, ILobSystemInstance)

Crée un élément externe avec une identité spécifique, associée à d'autres éléments externes et affecte tous les champs de type de contenu externe les valeurs donnés avec une mise à jour.

Espace de noms :  Microsoft.BusinessData.MetadataModel
Assembly :  Microsoft.BusinessData (dans Microsoft.BusinessData.dll)

Syntaxe

'Déclaration
Function CreateWithFields ( _
    fieldValues As IFieldValueDictionary, _
    assignedIdentity As Identity, _
    associatedInstances As AssociationEntityInstancesDictionary, _
    lsi As ILobSystemInstance _
) As EntityInstanceReference
'Utilisation
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
)

Paramètres

• fieldValues
  Type : Microsoft.BusinessData.Runtime.IFieldValueDictionary

  Paramètres de la méthode Create .

• assignedIdentity
  Type : Microsoft.BusinessData.Runtime.Identity

  L'identité doivent être affectées à l'instance.

• associatedInstances
  Type : Microsoft.BusinessData.Runtime.AssociationEntityInstancesDictionary

  Les éléments externes qui sont associées à cette instance lors de la création.

• lsi
  Type : Microsoft.BusinessData.MetadataModel.ILobSystemInstance

  L'instance du système externe.

Valeur renvoyée

Type : Microsoft.BusinessData.Runtime.EntityInstanceReference
Une référence à l'instance nouvellement créé.

Remarques

Vous pouvez utiliser cette méthode pour créer un élément externe en spécifiant les valeurs des champs de l'élément externe créé. Si la Create MethodInstance accepte tous les champs qui sont proposées, BDC appelle simplement la Create MethodInstance. Dans le cas contraire, BDC appelle également Update MethodInstance sur l'élément externe créé pour définir les valeurs spécifiées pour les champs restants. Si l'opération Create a réussi, et l'opération de mise à jour qui en résulte échoue, cette opération génère un PartialCreateException, qui contiendra la Identity de l'instance créée.

La méthode retourne la EntityInstanceReference à l'élément externe qui a été créé. L'instance IFieldValueDictionary fournie comme une entrée à cette méthode doit être créé à partir d'un View qui correspond à un MethodInstance de type SpecificFinder, obtenues via la méthode GetCreatorView(String) .

Le mode de fonctionnement peut être indiqué pour cette méthode. Pour plus d'informations sur l'utilisation de modes de fonctionnement, consultez OperationMode.

Instances d'objets dans le modèle objet Business Data Connectivity sont liés au magasin de métadonnées sont accessibles à partir de. L'utilisation d'instances liés à un magasin de métadonnées avec les instances à partir d'un autre magasin de métadonnées va entraîner l'altération des données et un comportement inattendu. Pour plus d'informations, voir DatabaseBackedMetadataCatalogFileBackedMetadataCataloget RemoteSharedFileBackedMetadataCatalog.

Voir aussi

Référence

IEntity interface

IEntity - Membres

CreateWithFields - Surcharge

Microsoft.BusinessData.MetadataModel - Espace de noms

Create(IFieldValueDictionary, Identity, AssociationEntityInstancesDictionary, ILobSystemInstance)