IEntity.CreateWithFields - Méthode (IFieldValueDictionary, Identity, ILobSystemInstance)
Crée un élément externe avec une identité affectée et affecte les valeurs donnés avec une mise à jour tous les champs de type de contenu externe.
Espace de noms : Microsoft.BusinessData.MetadataModel
Assembly : Microsoft.BusinessData (dans Microsoft.BusinessData.dll)
Syntaxe
'Déclaration
Function CreateWithFields ( _
fieldValues As IFieldValueDictionary, _
assignedIdentity As Identity, _
lsi As ILobSystemInstance _
) As EntityInstanceReference
'Utilisation
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
)
Paramètres
fieldValues
Type : Microsoft.BusinessData.Runtime.IFieldValueDictionaryParamètres de la méthode Create .
assignedIdentity
Type : Microsoft.BusinessData.Runtime.IdentityL'identité est affectée à l'instance.
lsi
Type : Microsoft.BusinessData.MetadataModel.ILobSystemInstanceL'instance du système externe.
Valeur renvoyée
Type : Microsoft.BusinessData.Runtime.EntityInstanceReference
Une référence à la nouvelle instance.
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.