Gewusst wie: Definieren eines Modells mit gespeicherten Prozeduren für Änderungen (Entity Framework)

Beim Ändern von Entitätsdaten können Sie anhand des Entity Framework gespeicherte Prozeduren angeben, die verwendet werden sollen. Diese gespeicherten Prozeduren ersetzen die vom Entity Framework generierten Methoden. Gespeicherte Prozeduren werden implizit aufgerufen, sodass keine Änderungen an dem im konzeptionellen Schema definierten Datenmodell oder am vorhandenen Code der Anwendung erforderlich sind. Weitere Informationen finden Sie unter Unterstützung für gespeicherte Prozeduren (Entity Framework).

In diesem Thema wird erläutert, wie die gespeicherten Änderungsprozeduren für den SalesOrderDetail Entitätstyp im Adventure Works Sales-Modell definiert werden können. Um dieses Beispiel zu verwenden, müssen Sie Ihrem Projekt bereits das AdventureWorks Sales-Modell hinzugefügt und das Projekt zur Verwendung des Entity Framework konfiguriert haben. Führen Sie dazu die Verfahren unter Gewusst wie: Manuelles Konfigurieren eines Entity Framework-Projekts und Gewusst wie: Manuelles Definieren eines Entity Data Model (Entity Framework) durch.

So definieren Sie gespeicherte Änderungsprozeduren für den SalesOrderDetail-Entitätstyp

1. Führen Sie die folgenden Transact-SQL-Skripts aus, um die gespeicherten Änderungsprozeduren in der AdventureWorks-Datenbank zu erstellen:

   • CreateSalesOrderDetail-Prozedur

     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-Prozedur

     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-Prozedur

     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. Fügen Sie die folgenden Funktionsdefinitionen zum Schemaelement der höchsten Ebene der SSDL-Schemadatei für das AdventureWorks Sales-Speichermodell hinzu:

           <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. Fügen Sie das folgende XML-Fragment innerhalb des EntityTypeMapping-Elements für das SalesOrderDetail in der EntitySetMapping ein. Dieser Vorgang muss in der MSL-Zuordnungsdatei für das AdventureWorks Sales-Speichermodell ausgeführt werden.

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

Siehe auch

Konzepte

Mapping von Zuordnungssätzen zu gespeicherten Prozeduren (Entity Framework)

Weitere Ressourcen

Definieren von erweiterten Datenmodellen (Entity Framework-Aufgaben)