É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)