Élément UpdateFunction (MSL)

Dans le langage MSL (Mapping Specification Language), l'élément UpdateFunction mappe la fonction de mise à jour d'un type d'entité du modèle conceptuel à une procédure stockée de la base de données sous-jacente. Les procédures stockées auxquelles des fonctions de modification sont mappées doivent être déclarées dans le modèle de stockage. Pour plus d'informations, consultez Élément Function (SSDL).

Remarque :
Si vous ne mappez pas les trois opérations d'insertion, de mise à jour ou de suppression d'un type d'entité aux procédures stockées, les opérations non mappées échouent au moment de l'exécution et une exception UpdateException est levée.

L'élément UpdateFunction peut être un enfant de l'élément ModificationFunctionMapping et être appliqué à l'élément EntityTypeMapping.

L'élément UpdateFunction peut avoir les éléments enfants suivants :

• AssociationEnd (zéro, un ou plusieurs éléments) ;

• ComplexProperty (zéro, un ou plusieurs éléments) ;

• ResultBinding (zéro ou un élément) ;

• ScalarProperty (zéro, un ou plusieurs éléments).

Attributs applicables

Le tableau ci-dessous décrit les attributs qui peuvent s'appliquer à l'élément UpdateFunction.

Nom d'attribut	Requis	Valeur
FunctionName	Oui	Nom qualifié par un espace de noms de la procédure stockée à laquelle la fonction de mise à jour est mappée. La procédure stockée doit être déclarée dans le modèle de stockage.
RowsAffectedParameter	Non	Nom du paramètre de sortie qui retourne le nombre de lignes affectées.

Exemple

L'exemple suivant est basé sur le modèle School et présente l'élément UpdateFunction utilisé pour mapper la fonction de mise à jour du type d'entité Person à la procédure stockée UpdatePerson. La procédure stockée UpdatePerson est déclarée dans le modèle de stockage.

<EntityTypeMapping TypeName="SchoolModel.Person">
  <ModificationFunctionMapping>
    <InsertFunction FunctionName="SchoolModel.Store.InsertPerson">
      <ScalarProperty Name="EnrollmentDate"
                      ParameterName="EnrollmentDate" />
      <ScalarProperty Name="HireDate" ParameterName="HireDate" />
      <ScalarProperty Name="FirstName" ParameterName="FirstName" />
      <ScalarProperty Name="LastName" ParameterName="LastName" />
      <ResultBinding Name="PersonID" ColumnName="NewPersonID" />
    </InsertFunction>
    <UpdateFunction FunctionName="SchoolModel.Store.UpdatePerson">
      <ScalarProperty Name="EnrollmentDate"
                      ParameterName="EnrollmentDate"
                      Version="Current" />
      <ScalarProperty Name="HireDate" ParameterName="HireDate"
                      Version="Current" />
      <ScalarProperty Name="FirstName" ParameterName="FirstName"
                      Version="Current" />
      <ScalarProperty Name="LastName" ParameterName="LastName"
                      Version="Current" />
      <ScalarProperty Name="PersonID" ParameterName="PersonID"
                      Version="Current" />
    </UpdateFunction>
    <DeleteFunction FunctionName="SchoolModel.Store.DeletePerson">
      <ScalarProperty Name="PersonID" ParameterName="PersonID" />
    </DeleteFunction>
  </ModificationFunctionMapping>
</EntityTypeMapping>

Voir aussi

Autres ressources

Spécifications CSDL, SSDL et MSL
Modélisation et mappage (Entity Framework)