IEntity.CreateWithFields - Méthode (IFieldValueDictionary, ILobSystemInstance, OperationMode)
Crée un élément externe avec une instance de système externe, un mode de fonctionnement spécifiques 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, _
lsi As ILobSystemInstance, _
mode As OperationMode _
) As EntityInstanceReference
'Utilisation
Dim instance As IEntity
Dim fieldValues As IFieldValueDictionary
Dim lsi As ILobSystemInstance
Dim mode As OperationMode
Dim returnValue As EntityInstanceReference
returnValue = instance.CreateWithFields(fieldValues, _
lsi, mode)
EntityInstanceReference CreateWithFields(
IFieldValueDictionary fieldValues,
ILobSystemInstance lsi,
OperationMode mode
)
Paramètres
fieldValues
Type : Microsoft.BusinessData.Runtime.IFieldValueDictionaryParamètres de la méthode Create .
lsi
Type : Microsoft.BusinessData.MetadataModel.ILobSystemInstanceL'instance du système externe.
mode
Type : Microsoft.BusinessData.Runtime.OperationModeLe mode dans lequel vous souhaitez créer l'instance d'élément 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.