Procédure : définir un modèle avec des procédures stockées de modification (Entity Framework)

Entity Framework vous permet de spécifier des procédures stockées à utiliser lors de la modification de données d'entité. Ces procédures stockées remplacent les méthodes générées par Entity Framework. Les procédures stockées sont appelées de façon implicite, de sorte qu'aucune modification du modèle de données défini dans le schéma conceptuel ou un code d'application existant n'est requise. Pour plus d'informations, voir Prise en charge des procédures stockées (Entity Framework).

Cette rubrique montre comment définir des procédures stockées de modification pour le type d'entité SalesOrderDetail du modèle de vente Adventure Works Sales Model. Pour utiliser cet exemple, vous devez déjà avoir ajouté le modèle de vente AdventureWorks Sales Model à votre projet et configuré ce dernier pour qu'il utilise Entity Framework. Pour cela, exécutez les procédures décrites dans Procédure : configurer manuellement un projet Entity Framework et Procédure : définir manuellement un modèle EDM (Entity Data Model) (Entity Framework).

Pour définir des procédures stockées de modification pour le type d'entité SalesOrderDetail

1. Exécutez les scripts Transact-SQL suivants pour créer les procédures stockées de modification dans la base de données AdventureWorks :

   • Procédure CreateSalesOrderDetail

     USE [AdventureWorks]
     GO
     SET ANSI_NULLS ON
     GO
     SET QUOTED_IDENTIFIER ON
     GO
     IF OBJECT_ID ( 'dbo.CreateSalesOrderDetail', 'P' ) IS NOT NULL 
     DROP PROCEDURE dbo.CreateSalesOrderDetail;
     GO
     CREATE PROCEDURE [dbo].[CreateSalesOrderDetail] 
        @SalesOrderID int,
        @CarrierTrackingNumber nvarchar(25),
        @OrderQty smallint,
        @ProductID int,
        @SpecialOfferID int,
        @UnitPrice money,
        @UnitPriceDiscount money,
        @rowguid uniqueidentifier,
        @ModifiedDate datetime
     
     AS
     
     INSERT INTO [AdventureWorks].[Sales].[SalesOrderDetail]
                ([SalesOrderID]
                ,[CarrierTrackingNumber]
                ,[OrderQty]
                ,[ProductID]
                ,[SpecialOfferID]
                ,[UnitPrice]
                ,[UnitPriceDiscount]
                ,[rowguid]
                ,[ModifiedDate])
          VALUES
                (@SalesOrderID,
                @CarrierTrackingNumber,
                @OrderQty,
                @ProductID,
                @SpecialOfferID,
                @UnitPrice,
                @UnitPriceDiscount,
                @rowguid,
                @ModifiedDate)
     
     select SalesOrderDetailID, LineTotal
      from [AdventureWorks].[Sales].[SalesOrderDetail]
      where SalesOrderID = @SalesOrderID and SalesOrderDetailID = scope_identity() 
     

   • Procédure UpdateSalesOrderDetail

     USE [AdventureWorks]
     GO
     SET ANSI_NULLS ON
     GO
     SET QUOTED_IDENTIFIER ON
     GO
     IF OBJECT_ID ( 'dbo.UpdateSalesOrderDetail', 'P' ) IS NOT NULL 
     DROP PROCEDURE dbo.UpdateSalesOrderDetail;
     GO
     
     CREATE PROCEDURE [dbo].[UpdateSalesOrderDetail]
        @OrderQty smallint, 
        @SalesOrderDetailID int,
        @SalesOrderID int
     
     AS
     UPDATE [AdventureWorks].[Sales].[SalesOrderDetail]
        SET [OrderQty] = @OrderQty
      WHERE SalesOrderDetailID = @SalesOrderDetailID 
     

   • Procédure DeleteSalesOrderDetail

     USE [AdventureWorks]
     GO
     SET ANSI_NULLS ON
     GO
     SET QUOTED_IDENTIFIER ON
     GO
     IF OBJECT_ID ( 'dbo.DeleteSalesOrderDetail', 'P' ) IS NOT NULL 
     DROP PROCEDURE dbo.DeleteSalesOrderDetail;
     GO
     
     CREATE PROCEDURE [dbo].[DeleteSalesOrderDetail] 
        @SalesOrderDetailID int,
        @SalesOrderID int 
     AS
     DELETE FROM [AdventureWorks].[Sales].[SalesOrderDetail]
           WHERE SalesOrderDetailID = @SalesOrderDetailID 
     

2. Ajoutez les définitions de fonction suivantes à l'élément Schema de niveau supérieur du fichier de schéma SSDL correspondant au modèle de stockage AdventureWorks Sales :

           <Function Name="CreateSalesOrderDetail" Aggregate="false"
                     BuiltIn="false" NiladicFunction="false"
                     IsComposable="false"
                     ParameterTypeSemantics="AllowImplicitConversion"
                     Schema="dbo">
             <Parameter Name="SalesOrderID" Type="int" Mode="In" />
             <Parameter Name="CarrierTrackingNumber" Type="nvarchar" Mode="In" />
             <Parameter Name="OrderQty" Type="smallint" Mode="In" />
             <Parameter Name="ProductID" Type="int" Mode="In" />
             <Parameter Name="SpecialOfferID" Type="int" Mode="In" />
             <Parameter Name="UnitPrice" Type="money" Mode="In" />
             <Parameter Name="UnitPriceDiscount" Type="money" Mode="In" />
             <Parameter Name="rowguid" Type="uniqueidentifier" Mode="In" />
             <Parameter Name="ModifiedDate" Type="datetime" Mode="In" />
           </Function>
   
           <Function Name="UpdateSalesOrderDetail" Aggregate="false"
                     BuiltIn="false" NiladicFunction="false"
                     IsComposable="false"
                     ParameterTypeSemantics="AllowImplicitConversion"
                     Schema="dbo">
             <Parameter Name="OrderQty" Type="smallint" Mode="In"/>
             <Parameter Name="SalesOrderDetailID" Type="int" Mode="In"/>
             <Parameter Name="SalesOrderID" Type="int" Mode="In"/>
           </Function>
   
           <Function Name="DeleteSalesOrderDetail" Aggregate="false"
                     BuiltIn="false" NiladicFunction="false"
                     IsComposable="false"
                     ParameterTypeSemantics="AllowImplicitConversion"
                     Schema="dbo">
             <Parameter Name="SalesOrderDetailID" Type="int" Mode="In"/>
             <Parameter Name="SalesOrderID" Type="int" Mode="In"/>
           </Function> 
   

3. Insérez le fragment XML suivant dans l'élément EntityTypeMapping pour le SalesOrderDetail d'EntitySetMapping. Effectuez cette opération dans le fichier mappage MSL du modèle du stockage AdventureWorks Sales.

     <ModificationFunctionMapping >
       <InsertFunction
          FunctionName="AdventureWorksModel.Store.CreateSalesOrderDetail">
           <ScalarProperty Name="CarrierTrackingNumber"
                 ParameterName="CarrierTrackingNumber" Version="Current"/>
           <ScalarProperty Name="OrderQty" ParameterName="OrderQty"
                 Version="Current"/>
           <ScalarProperty Name="ProductID" ParameterName="ProductID" Version="Current"/>
            <ScalarProperty Name="SpecialOfferID"
                 ParameterName="SpecialOfferID" Version="Current"/>
           <ScalarProperty Name="UnitPrice" 
                 ParameterName="UnitPrice" Version="Current"/>
           <ScalarProperty Name="UnitPriceDiscount"
                 ParameterName="UnitPriceDiscount" Version="Current"/>
           <ScalarProperty Name="rowguid" ParameterName="rowguid"
                 Version="Current"/>
           <ScalarProperty Name="ModifiedDate"
                 ParameterName="ModifiedDate" Version="Current"/>
           <AssociationEnd
              AssociationSet="FK_SalesOrderDetail_SalesOrderHeader_SalesOrderID"
             From="SalesOrderDetail" To="SalesOrderHeader">
           <ScalarProperty Name="SalesOrderID"
                      ParameterName="SalesOrderID" />
           </AssociationEnd>
           <ResultBinding ColumnName="SalesOrderDetailID"
                      Name="SalesOrderDetailID" />
            <ResultBinding ColumnName="LineTotal" Name="LineTotal" />
     </InsertFunction>
   
       <UpdateFunction
       FunctionName="AdventureWorksModel.Store.UpdateSalesOrderDetail" >
           <ScalarProperty Name="OrderQty" ParameterName="OrderQty"
                Version="Current"/>
           <ScalarProperty Name="SalesOrderDetailID"
              ParameterName="SalesOrderDetailID" Version="Current"/>
           <AssociationEnd
       AssociationSet="FK_SalesOrderDetail_SalesOrderHeader_SalesOrderID"
          From="SalesOrderDetail" To="SalesOrderHeader">
             <ScalarProperty Name="SalesOrderID"
               ParameterName="SalesOrderID" Version="Current" />
           </AssociationEnd>
       </UpdateFunction>
   
       <DeleteFunction
        FunctionName="AdventureWorksModel.Store.DeleteSalesOrderDetail" >
           <ScalarProperty Name="SalesOrderDetailID"
              ParameterName="SalesOrderDetailID" Version="Original"/>
           <AssociationEnd
              AssociationSet="FK_SalesOrderDetail_SalesOrderHeader_SalesOrderID"
             From="SalesOrderDetail" To="SalesOrderHeader">
           <ScalarProperty Name="SalesOrderID"
                     ParameterName="SalesOrderID" />
           </AssociationEnd>
       </DeleteFunction>
     </ModificationFunctionMapping> 
   

Voir aussi

Concepts

Mappage d'ensembles d'associations à des procédures stockées (Entity Framework)

Autres ressources

Définition de modèles de données avancés (Tâches Entity Framework)