Как определить модель с помощью хранимых процедур модификации (платформа Entity Framework)

Платформа Entity Framework позволяет задавать хранимые процедуры, используемые при изменении данных сущности. Эти хранимые процедуры заменяют методы, сформированные платформой Entity Framework. Хранимые процедуры вызываются неявно, поэтому вносить изменения в модель данных, определенную в концептуальной схеме, или в существующий код приложения нет необходимости. Дополнительные сведения см. в разделе Поддержка хранимых процедур (платформа Entity Framework).

В этом разделе показано, как определить хранимые процедуры модификации для типа сущности SalesOrderDetail в модели Adventure Works Sales. Чтобы иметь возможность использовать этот пример, необходимо добавить модель AdventureWorks Sales к конкретному проекту и настроить проект на применение платформы Entity Framework. Для этого выполните инструкции из разделов Как вручную настроить проект Entity Framework и Как определить модель EDM вручную (платформа Entity Framework).

Определение хранимых процедур модификации для типа сущности SalesOrderDetail

1. Выполните следующие сценарии Transact-SQL, чтобы создать хранимые процедуры модификации в базе данных AdventureWorks.

   • Процедура 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() 
     

   • Процедура 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 
     

   • Процедура 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. Добавьте следующие определения функций в элемент Schema верхнего уровня в файле SSDL-схемы для модели хранения 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. Вставьте следующий фрагмент кода XML в элемент EntityTypeMapping, относящийся к SalesOrderDetail в EntitySetMapping. Внесите это изменение в файл сопоставления на языке MSL для модели хранения 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> 
   

См. также

Основные понятия

Сопоставление набора ассоциаций с хранимыми процедурами (платформа Entity Framework)

Другие ресурсы

Определение расширенных моделей данных (задачи платформы Entity Framework)