共用方式為

MSL 規格

  • 發行項

對應規格語言 （MSL） 是以 XML 為基礎的語言，描述 Entity Framework 應用程式的概念模型和儲存模型之間的對應。

在 Entity Framework 應用程式中，對應中繼資料會在建置時從 .msl 檔案（以 MSL 撰寫）載入。 Entity Framework 會在執行時間使用對應中繼資料，將查詢轉譯為概念模型，以儲存特定的命令。

Entity Framework Designer （EF Designer） 會在設計階段將對應資訊儲存在 .edmx 檔案中。 在建置階段，實體設計工具會使用 .edmx 檔案中的資訊，在執行時間建立 Entity Framework 所需的 .msl 檔案

MSL 中所參考之所有概念或儲存模型類型的名稱必須以它們各自的命名空間名稱來限定。 如需概念模型命名空間名稱的相關資訊，請參閱 CSDL 規格 。 如需儲存體模型命名空間名稱的相關資訊，請參閱 SSDL 規格 。

MSL 的版本會以 XML 命名空間區分。

MSL 版本 XML 命名空間
MSL v1 urn：schemas-microsoft-com：windows：storage：mapping：CS
MSL v2 https://schemas.microsoft.com/ado/2008/09/mapping/cs
MSL v3 https://schemas.microsoft.com/ado/2009/11/mapping/cs

Alias 元素 (MSL)

對應規格語言 （MSL） 中的 Alias 元素是 Mapping 元素的子系，用來定義概念模型和儲存模型命名空間的別名。 MSL 中所參考之所有概念或儲存模型類型的名稱必須以它們各自的命名空間名稱來限定。 如需概念模型命名空間名稱的相關資訊，請參閱 Schema Element （CSDL）。 如需儲存體模型命名空間名稱的相關資訊，請參閱 Schema Element （SSDL）。

Alias 元素不能有子專案。

適用屬性

下表描述可套用至 Alias 元素的屬性。

屬性名稱 是必要的 值
索引鍵 Yes Value 屬性所指定之命名空間的 別名。
值 Yes Key 元素值是別名的 命名空間。

範例

下列範例顯示 針對概念模型中定義的型別，定義別名 c 的 Alias 元素。

 <Mapping Space="C-S"
          xmlns="https://schemas.microsoft.com/ado/2009/11/mapping/cs">
   <Alias Key="c" Value="SchoolModel"/>
   <EntityContainerMapping StorageEntityContainer="SchoolModelStoreContainer"
                           CdmEntityContainer="SchoolModelEntities">
     <EntitySetMapping Name="Courses">
       <EntityTypeMapping TypeName="c.Course">
         <MappingFragment StoreEntitySet="Course">
           <ScalarProperty Name="CourseID" ColumnName="CourseID" />
           <ScalarProperty Name="Title" ColumnName="Title" />
           <ScalarProperty Name="Credits" ColumnName="Credits" />
           <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
         </MappingFragment>
       </EntityTypeMapping>
     </EntitySetMapping>
     <EntitySetMapping Name="Departments">
       <EntityTypeMapping TypeName="c.Department">
         <MappingFragment StoreEntitySet="Department">
           <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
           <ScalarProperty Name="Name" ColumnName="Name" />
           <ScalarProperty Name="Budget" ColumnName="Budget" />
           <ScalarProperty Name="StartDate" ColumnName="StartDate" />
           <ScalarProperty Name="Administrator" ColumnName="Administrator" />
         </MappingFragment>
       </EntityTypeMapping>
     </EntitySetMapping>
   </EntityContainerMapping>
 </Mapping>

AssociationEnd 項目 (MSL)

當 概念模型中實體類型的修改函式對應至基礎資料庫中的預存程式時，會使用對應規格語言的 AssociationEnd 元素。 如果修改預存程式採用其值保留在關聯屬性中的參數， AssociationEnd 元素會將屬性值對應至 參數。 如需詳細資訊，請參閱下列範例。

如需將實體類型修改函式對應至預存程式的詳細資訊，請參閱 ModificationFunctionMapping 元素 （MSL） 和逐步解說：將實體對應至預存程式。

AssociationEnd 元素可以有下列子項目：

  • ScalarProperty

適用屬性

下表描述適用于 AssociationEnd 元素的屬性。

屬性名稱 是必要的 值
AssociationSet Yes 要對應的關聯名稱。
自 Yes 對應至所對應關聯之導覽屬性的 FromRole 屬性值。 如需詳細資訊，請參閱 NavigationProperty 元素 （CSDL）。
目標 Yes 對應至所對應關聯之導覽屬性的 ToRole 屬性值。 如需詳細資訊，請參閱 NavigationProperty 元素 （CSDL）。

範例

請考慮下列概念模型實體類型：

 <EntityType Name="Course">
   <Key>
     <PropertyRef Name="CourseID" />
   </Key>
   <Property Type="Int32" Name="CourseID" Nullable="false" />
   <Property Type="String" Name="Title" Nullable="false" MaxLength="100"
             FixedLength="false" Unicode="true" />
   <Property Type="Int32" Name="Credits" Nullable="false" />
   <NavigationProperty Name="Department"
                       Relationship="SchoolModel.FK_Course_Department"
                       FromRole="Course" ToRole="Department" />
 </EntityType>

同時請考慮下列預存程序：

 CREATE PROCEDURE [dbo].[UpdateCourse]
                                @CourseID int,
                                @Title nvarchar(50),
                                @Credits int,
                                @DepartmentID int
                                AS
                                UPDATE Course SET Title=@Title,
                                                              Credits=@Credits,
                                                              DepartmentID=@DepartmentID
                                WHERE CourseID=@CourseID;

若要將實體的 Course update 函式對應至這個預存程式，您必須提供值給 DepartmentID 參數。 DepartmentID 的值不會對應至實體類型上的屬性；它會包含在獨立關聯中，該關聯的對應如下所示：

 <AssociationSetMapping Name="FK_Course_Department"
                        TypeName="SchoolModel.FK_Course_Department"
                        StoreEntitySet="Course">
   <EndProperty Name="Course">
     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
   </EndProperty>
   <EndProperty Name="Department">
     <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
   </EndProperty>
 </AssociationSetMapping>

下列程式碼顯示 AssociationEnd 元素，用來將FK_Course_Department 關聯之 DepartmentID 屬性 對應 至 UpdateCourse 預存程式（Course 實體類型的更新函 式已對應至該預存程式）：

 <EntitySetMapping Name="Courses">
   <EntityTypeMapping TypeName="SchoolModel.Course">
     <MappingFragment StoreEntitySet="Course">
       <ScalarProperty Name="Credits" ColumnName="Credits" />
       <ScalarProperty Name="Title" ColumnName="Title" />
       <ScalarProperty Name="CourseID" ColumnName="CourseID" />
     </MappingFragment>
   </EntityTypeMapping>
   <EntityTypeMapping TypeName="SchoolModel.Course">
     <ModificationFunctionMapping>
       <UpdateFunction FunctionName="SchoolModel.Store.UpdateCourse">
         <AssociationEnd AssociationSet="FK_Course_Department"
                         From="Course" To="Department">
           <ScalarProperty Name="DepartmentID"
                           ParameterName="DepartmentID"
                           Version="Current" />
         </AssociationEnd>
         <ScalarProperty Name="Credits" ParameterName="Credits"
                         Version="Current" />
         <ScalarProperty Name="Title" ParameterName="Title"
                         Version="Current" />
         <ScalarProperty Name="CourseID" ParameterName="CourseID"
                         Version="Current" />
       </UpdateFunction>
     </ModificationFunctionMapping>
   </EntityTypeMapping>
 </EntitySetMapping>

AssociationSetMapping 項目 (MSL)

對應規格語言中的 AssociationSetMapping 專案會定義基礎資料庫中概念模型關聯與資料表資料行之間的對應。

概念模型中的關聯指其屬性代表基礎資料庫中主要與外部索引鍵資料行的類型。 AssociationSetMapping 元素會使用兩個 EndProperty 元素來定義資料庫中關聯類型屬性和資料行之間的對應。 您可以使用 Condition 元素在這些對應上放置條件。 使用 ModificationFunctionMapping 元素，將關聯之插入、更新和刪除函式對應至資料庫中的預存程式。 使用 QueryView 元素中的 Entity SQL 字串，定義關聯與資料表資料行之間的唯讀對應。

注意

如果為概念模型中的關聯定義引用條件約束，則關聯不需要與 AssociationSetMapping 元素對應。 如果 AssociationSetMapping 元素存在具有引用條件約束的 關聯，則會忽略 AssociationSetMapping 元素中定義的對應。 如需詳細資訊，請參閱 ReferentialConstraint 元素 （CSDL）。

AssociationSetMapping 元素可以有下列子項目

  • QueryView （零或一個）
  • EndProperty （零或兩個）
  • 條件 （零個或多個）
  • ModificationFunctionMapping （零或一個）

適用屬性

下表描述可套用至 AssociationSetMapping 元素的屬性。

屬性名稱 是必要的 值
名稱 Yes 要對應的概念模型關聯集名稱。
TypeName No 要對應的概念模型關聯類型之命名空間限定名稱。
StoreEntitySet No 要對應的資料表名稱。

範例

下列範例顯示 AssociationSetMapping 元素，其中 概念模型中FK_Course_Department 關聯集會對應至資料庫中的 Course 資料表。 關聯類型屬性和資料表資料行之間的對應是在子 EndProperty 元素中指定。

 <AssociationSetMapping Name="FK_Course_Department"
                        TypeName="SchoolModel.FK_Course_Department"
                        StoreEntitySet="Course">
   <EndProperty Name="Department">
     <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
   </EndProperty>
   <EndProperty Name="Course">
     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
   </EndProperty>
 </AssociationSetMapping>

ComplexProperty 項目 (MSL)

對應規格語言中的 ComplexProperty 元素會定義基礎資料庫中概念模型實體類型和資料表資料行上複雜類型屬性之間的對應。 屬性資料行對應是在子 ScalarProperty 元素中指定。

ComplexType 屬性元素可以有下列子項目：

  • ScalarProperty （零個或多個）
  • ComplexProperty （零個或多個）
  • ComplexTypeMapping （零個或多個）
  • 條件 （零個或多個）

適用屬性

下表描述適用于 ComplexProperty 元素的屬性：

屬性名稱 是必要的 值
名稱 Yes 概念模型中要對應的實體類型之複雜屬性的名稱。
TypeName No 概念模型屬性類型的命名空間限定名稱。

範例

下列範例是以學校模型為基礎。 下列複雜型別已加入至概念模型：

 <ComplexType Name="FullName">
   <Property Type="String" Name="LastName"
             Nullable="false" MaxLength="50"
             FixedLength="false" Unicode="true" />
   <Property Type="String" Name="FirstName"
             Nullable="false" MaxLength="50"
             FixedLength="false" Unicode="true" />
 </ComplexType>

Person 實體類型的 LastName 和 FirstName 屬性 已取代為一個複雜屬性 Name ： 

 <EntityType Name="Person">
   <Key>
     <PropertyRef Name="PersonID" />
   </Key>
   <Property Name="PersonID" Type="Int32" Nullable="false"
             annotation:StoreGeneratedPattern="Identity" />
   <Property Name="HireDate" Type="DateTime" />
   <Property Name="EnrollmentDate" Type="DateTime" />
   <Property Name="Name" Type="SchoolModel.FullName" Nullable="false" />
 </EntityType>

下列 MSL 顯示 ComplexProperty 元素，用來將 Name 屬性對應至基礎資料庫中的資料行：

 <EntitySetMapping Name="People">
   <EntityTypeMapping TypeName="SchoolModel.Person">
     <MappingFragment StoreEntitySet="Person">
       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
       <ScalarProperty Name="HireDate" ColumnName="HireDate" />
       <ScalarProperty Name="EnrollmentDate" ColumnName="EnrollmentDate" />
       <ComplexProperty Name="Name" TypeName="SchoolModel.FullName">
         <ScalarProperty Name="FirstName" ColumnName="FirstName" />
         <ScalarProperty Name="LastName" ColumnName="LastName" />  
       </ComplexProperty>
     </MappingFragment>
   </EntityTypeMapping>
 </EntitySetMapping>

ComplexTypeMapping 項目 (MSL)

對應規格語言中的 ComplexTypeMapping 元素 （MSL） 是 ResultMapping 專案的子系，並在下列情況成立時定義概念模型中的函數匯入與基礎資料庫中預存程式之間的對應：

  • 函式匯入會傳回概念複雜類型。
  • 預存程序所傳回之資料行名稱未與複雜類型上的屬性名稱完全相符。

根據預設，預存程序所傳回之資料行與複雜類型間的對應是以資料行和屬性名稱為基礎。 如果資料行名稱與屬性名稱不完全相符，您必須使用 ComplexTypeMapping 元素來定義對應。 如需預設對應的範例，請參閱 FunctionImportMapping 元素 （MSL）。

ComplexTypeMapping 元素可以有下列子項目：

  • ScalarProperty （零個或多個）

適用屬性

下表描述適用于 ComplexTypeMapping 元素的屬性。

屬性名稱 是必要的 值
TypeName Yes 要對應的複雜類型的命名空間限定名稱。

範例

請考慮下列預存程序：

 CREATE PROCEDURE [dbo].[GetGrades]
             @student_Id int
             AS
             SELECT     EnrollmentID as enroll_id,
                                                                             Grade as grade,
                                                                             CourseID as course_id,
                                                                             StudentID as student_id
                                               FROM dbo.StudentGrade
             WHERE StudentID = @student_Id

同時請考慮下列概念模型複雜類型：

 <ComplexType Name="GradeInfo">
   <Property Type="Int32" Name="EnrollmentID" Nullable="false" />
   <Property Type="Decimal" Name="Grade" Nullable="true"
             Precision="3" Scale="2" />
   <Property Type="Int32" Name="CourseID" Nullable="false" />
   <Property Type="Int32" Name="StudentID" Nullable="false" />
 </ComplexType>

若要建立傳回先前複雜型別實例的函式匯入，預存程式和實體類型所傳回之資料行之間的對應必須在 ComplexTypeMapping 元素中 定義：

 <FunctionImportMapping FunctionImportName="GetGrades"
                        FunctionName="SchoolModel.Store.GetGrades" >
   <ResultMapping>
     <ComplexTypeMapping TypeName="SchoolModel.GradeInfo">
       <ScalarProperty Name="EnrollmentID" ColumnName="enroll_id"/>
       <ScalarProperty Name="CourseID" ColumnName="course_id"/>
       <ScalarProperty Name="StudentID" ColumnName="student_id"/>
       <ScalarProperty Name="Grade" ColumnName="grade"/>
     </ComplexTypeMapping>
   </ResultMapping>
 </FunctionImportMapping>

Condition 項目 (MSL)

對應 規格語言中的 Condition 元素 （MSL） 會將條件放在概念模型與基礎資料庫之間的對應上。 如果符合子 Condition 元素中指定的所有條件，則 XML 節點內定義的對應是有效的。 否則，對應無效。 例如，如果 MappingFragment 元素包含一或多個 Condition 子項目，則只有在符合子 Condition 元素的所有條件時，在 MappingFragment 節點內 定義的對應才會有效。

每個條件都可以套用至 Name（由 Name 屬性指定的 概念模型實體屬性名稱），或 ColumnName（資料庫中資料行的名稱，由 ColumnName 屬性指定）。 設定 Name 屬性時，會根據實體屬性值檢查條件。 設定 ColumnName 屬性時，會根據資料行值檢查條件。 Condition 元素中只能指定其中一個 Name 或 ColumnName 屬性。

注意

當 FunctionImportMapping 元素內使用 Condition 元素時，僅 適用 Name 屬性。

Condition 元素可以是下列元素的子系：

  • AssociationSetMapping
  • ComplexProperty
  • EntitySetMapping
  • MappingFragment
  • EntityTypeMapping

Condition 元素不能有子專案。

適用屬性

下表描述適用于 Condition 元素的屬性：

屬性名稱 是必要的 值
ColumnName No 其值用來評估條件之資料表資料行的名稱。
IsNull No True 或 False 。 如果值為 True ，且資料行值為 Null ，或值為 False 且資料行值不是 Null ，則條件為 true。 否則，條件不成立。
無法同時使用 IsNull 和 Value 屬性。
值 No 要與資料行值比較的值。 如果值相同，則條件成立。 否則，條件不成立。
無法同時使用 IsNull 和 Value 屬性。
名稱 No 其值用來評估條件之概念模型實體屬性的名稱。
如果在 FunctionImportMapping 元素內使用 Condition 元素， 則此屬性不適用。

範例

下列範例將 Condition 元素顯示為 MappingFragment 元素的 子 系。 當 HireDate 不是 Null 且 EnrollmentDate 為 null 時 ，Data 會對應到 SchoolModel.Instructor 類型與 Person 資料表的 PersonID 和 HireDate 資料行之間 。 當 EnrollmentDate 不是 Null 且 HireDate 為 null 時 ，資料會對應到 SchoolModel.Student 類型與 Person 資料表的 PersonID 和 Enrollment 資料行之間 。

 <EntitySetMapping Name="People">
   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel.Person)">
     <MappingFragment StoreEntitySet="Person">
       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
       <ScalarProperty Name="FirstName" ColumnName="FirstName" />
       <ScalarProperty Name="LastName" ColumnName="LastName" />
     </MappingFragment>
   </EntityTypeMapping>
   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel.Instructor)">
     <MappingFragment StoreEntitySet="Person">
       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
       <ScalarProperty Name="HireDate" ColumnName="HireDate" />
       <Condition ColumnName="HireDate" IsNull="false" />
       <Condition ColumnName="EnrollmentDate" IsNull="true" />
     </MappingFragment>
   </EntityTypeMapping>
   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel.Student)">
     <MappingFragment StoreEntitySet="Person">
       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
       <ScalarProperty Name="EnrollmentDate"
                       ColumnName="EnrollmentDate" />
       <Condition ColumnName="EnrollmentDate" IsNull="false" />
       <Condition ColumnName="HireDate" IsNull="true" />
     </MappingFragment>
   </EntityTypeMapping>
 </EntitySetMapping>

DeleteFunction 項目 (MSL)

對應規格語言 （MSL） 中的 DeleteFunction 元素會將概念模型中實體類型的 delete 函式或關聯對應至基礎資料庫中的預存程式。 修改函式所對應的預存程序必須在儲存體模型中宣告。 如需詳細資訊，請參閱 Function 元素 （SSDL）。

注意

如果您未將實體類型的所有三個插入、更新或刪除作業對應至預存程式，則如果在執行時間執行且擲回 UpdateException，則未對應的作業將會失敗。

套用至 EntityTypeMapping 的 DeleteFunction

套用至 EntityTypeMapping 元素時， DeleteFunction 元素會將概念模型中實體類型的 delete 函式對應至預存程式。

當套用至 EntityTypeMapping 元素時，DeleteFunction 元素可以有下列子項目：

  • AssociationEnd （零個或多個）
  • ComplexProperty （零個或多個）
  • ScalarProperty （零個或多個）

適用屬性

下表描述當它套用至 EntityTypeMapping 元素時，可以套用至 DeleteFunction 元素的屬性。

屬性名稱 是必要的 值
FunctionName Yes 刪除函式所對應至之預存程序的命名空間限定名稱。 預存程序必須已宣告於儲存模型中。
RowsAffectedParameter No 會傳回受影響之資料列數的輸出參數名稱。

範例

下列範例是以 School 模型為基礎，並顯示 DeleteFunction 元素，將 Person 實體類型的 delete 函式對應至 DeletePerson 預存程式。 DeletePerson 預存程式會在儲存體模型中宣告。

 <EntitySetMapping Name="People">
   <EntityTypeMapping TypeName="SchoolModel.Person">
     <MappingFragment StoreEntitySet="Person">
       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
       <ScalarProperty Name="LastName" ColumnName="LastName" />
       <ScalarProperty Name="FirstName" ColumnName="FirstName" />
       <ScalarProperty Name="HireDate" ColumnName="HireDate" />
       <ScalarProperty Name="EnrollmentDate"
                       ColumnName="EnrollmentDate" />
     </MappingFragment>
 </EntityTypeMapping>
   <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>
 </EntitySetMapping>

套用至 AssociationSetMapping 的 DeleteFunction

當套用至 AssociationSetMapping 元素時， DeleteFunction 元素會將概念模型中關聯之 delete 函式對應至預存程式。

當套用至 AssociationSetMapping 元素時，DeleteFunction 元素可以有下列子項目：

  • EndProperty

適用屬性

下表描述當它套用至 AssociationSetMapping 元素時，可以套用至 DeleteFunction 元素的屬性。

屬性名稱 是必要的 值
FunctionName Yes 刪除函式所對應至之預存程序的命名空間限定名稱。 預存程序必須已宣告於儲存模型中。
RowsAffectedParameter No 會傳回受影響之資料列數的輸出參數名稱。

範例

下列範例是以 School 模型為基礎，並顯示 DeleteFunction 元素，用來將 CourseInstructor 關聯的 delete 函式對應至 DeleteCourseInstructor 預存程式。 DeleteCourseInstructor 預存程式會在儲存體模型中宣告。

 <AssociationSetMapping Name="CourseInstructor"
                        TypeName="SchoolModel.CourseInstructor"
                        StoreEntitySet="CourseInstructor">
   <EndProperty Name="Person">
     <ScalarProperty Name="PersonID" ColumnName="PersonID" />
   </EndProperty>
   <EndProperty Name="Course">
     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
   </EndProperty>
   <ModificationFunctionMapping>
     <InsertFunction FunctionName="SchoolModel.Store.InsertCourseInstructor" >   
       <EndProperty Name="Course">
         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
       </EndProperty>
       <EndProperty Name="Person">
         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
       </EndProperty>
     </InsertFunction>
     <DeleteFunction FunctionName="SchoolModel.Store.DeleteCourseInstructor">
       <EndProperty Name="Course">
         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
       </EndProperty>
       <EndProperty Name="Person">
         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
       </EndProperty>
     </DeleteFunction>
   </ModificationFunctionMapping>
 </AssociationSetMapping>

EndProperty 項目 (MSL)

對應規格語言 （MSL） 中的 EndProperty 元素會定義概念模型關聯與基礎資料庫之 end 或 modification 函式之間的對應。 屬性資料行對應是在子 ScalarProperty 元素中指定。

當 EndProperty 元素用來定義概念模型關聯結尾的對應時，它是 AssociationSetMapping 專案的子系。 當 EndProperty 元素用來定義概念模型關聯之修改函式的對應時，它是 InsertFunction 專案或 DeleteFunction 專案的子系。

EndProperty 元素可以有下列子項目：

  • ScalarProperty （零個或多個）

適用屬性

下表描述適用于 EndProperty 元素的屬性：

屬性名稱 是必要的 值
名稱 Yes 要對應的關聯端名稱。

範例

下列範例顯示 AssociationSetMapping 元素，其中 概念模型中FK_Course_Department 關聯會對應至資料庫中的 Course 資料表。 關聯類型屬性和資料表資料行之間的對應是在子 EndProperty 元素中指定。

 <AssociationSetMapping Name="FK_Course_Department"
                        TypeName="SchoolModel.FK_Course_Department"
                        StoreEntitySet="Course">
   <EndProperty Name="Department">
     <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
   </EndProperty>
   <EndProperty Name="Course">
     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
   </EndProperty>
 </AssociationSetMapping>

範例

下列範例顯示 EndProperty 元素， 會將關聯 （ CourseInstructor ） 的插入和刪除函式對應至基礎資料庫中的預存程式。 對應至的函式會在儲存體模型中宣告。

 <AssociationSetMapping Name="CourseInstructor"
                        TypeName="SchoolModel.CourseInstructor"
                        StoreEntitySet="CourseInstructor">
   <EndProperty Name="Person">
     <ScalarProperty Name="PersonID" ColumnName="PersonID" />
   </EndProperty>
   <EndProperty Name="Course">
     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
   </EndProperty>
   <ModificationFunctionMapping>
     <InsertFunction FunctionName="SchoolModel.Store.InsertCourseInstructor" >   
       <EndProperty Name="Course">
         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
       </EndProperty>
       <EndProperty Name="Person">
         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
       </EndProperty>
     </InsertFunction>
     <DeleteFunction FunctionName="SchoolModel.Store.DeleteCourseInstructor">
       <EndProperty Name="Course">
         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
       </EndProperty>
       <EndProperty Name="Person">
         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
       </EndProperty>
     </DeleteFunction>
   </ModificationFunctionMapping>
 </AssociationSetMapping>

EntityContainerMapping 項目 (MSL)

對應規格語言中的 EntityContainerMapping 專案會將概念模型中的實體容器對應至儲存體模型中的實體容器。 EntityContainerMapping 元素是 Mapping 元素的子系。

EntityContainerMapping 元素可以有下列子項目（依所列的順序）：

  • EntitySetMapping （零個或多個）
  • AssociationSetMapping （零或更多）
  • FunctionImportMapping （零個或多個）

適用屬性

下表描述可套用至 EntityContainerMapping 元素的屬性。

屬性名稱 是必要的 值
儲存體ModelContainer Yes 要對應至的儲存模型實體容器名稱。
CdmEntityContainer Yes 要對應的概念模型實體容器名稱。
GenerateUpdateViews No True 或 False 。 如果 為 False ，則不會產生任何更新檢視。 當您具有不正確唯讀對應時，此屬性應該設定為 False ，因為資料可能無法成功往返。
預設值是 True。

範例

下列範例顯示 EntityContainerMapping 元素，該元素會將 SchoolModelEntities 容器（概念模型實體容器）對應至 SchoolModelStoreContainer 容器（儲存體模型實體容器）：

 <EntityContainerMapping StorageEntityContainer="SchoolModelStoreContainer"
                         CdmEntityContainer="SchoolModelEntities">
   <EntitySetMapping Name="Courses">
     <EntityTypeMapping TypeName="c.Course">
       <MappingFragment StoreEntitySet="Course">
         <ScalarProperty Name="CourseID" ColumnName="CourseID" />
         <ScalarProperty Name="Title" ColumnName="Title" />
         <ScalarProperty Name="Credits" ColumnName="Credits" />
         <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
       </MappingFragment>
     </EntityTypeMapping>
   </EntitySetMapping>
   <EntitySetMapping Name="Departments">
     <EntityTypeMapping TypeName="c.Department">
       <MappingFragment StoreEntitySet="Department">
         <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
         <ScalarProperty Name="Name" ColumnName="Name" />
         <ScalarProperty Name="Budget" ColumnName="Budget" />
         <ScalarProperty Name="StartDate" ColumnName="StartDate" />
         <ScalarProperty Name="Administrator" ColumnName="Administrator" />
       </MappingFragment>
     </EntityTypeMapping>
   </EntitySetMapping>
 </EntityContainerMapping>

EntitySetMapping 項目 (MSL)

對應規格語言中的 EntitySetMapping 專案會將概念模型實體集中的所有類型對應至儲存體模型中的實體集。 概念模型中的實體集是相同類型實體實例的邏輯容器（和衍生類型）。 儲存體模型中的實體集代表基礎資料庫中的資料表或檢視表。 概念模型實體集是由 EntitySetMapping 元素的 Name 屬性值所指定。 對應至資料表或檢視表是由 每個子 MappingFragment 元素或 EntitySetMapping 元素本身中的 StoreEntitySet 屬性所指定。

EntitySetMapping 元素可以有下列子項目：

  • EntityTypeMapping （零個或多個）
  • QueryView （零或一個）
  • MappingFragment （零個或多個）

適用屬性

下表描述可套用至 EntitySetMapping 元素的屬性。

屬性名稱 是必要的 值
名稱 Yes 要對應的概念模型實體集名稱。
TypeName 1 No 要對應的概念模型實體類型名稱。
StoreEntitySet 1 No 要對應至的儲存模型實體集名稱。
MakeColumnsDistinct No True 或 False ，視是否只傳回相異資料列而定。
如果此屬性設定為 True ， EntityContainerMapping 專案的 GenerateUpdateViews 屬性必須設定為 False 。

 

1 TypeName 和 StoreEntitySet 屬性可用來取代 EntityTypeMapping 和 MappingFragment 子項目，將單一實體類型對應至單一資料表。

範例

下列範例顯示 EntitySetMapping 元素，該元素會將概念模型 Courses 實體集中的三種類型（基底類型和兩個衍生類型） 對應至基礎資料庫中的三個不同的資料表。 這些資料表是由 每個 MappingFragment 元素中的 StoreEntitySet 屬性所指定。

 <EntitySetMapping Name="Courses">
   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel1.Course)">
     <MappingFragment StoreEntitySet="Course">
       <ScalarProperty Name="CourseID" ColumnName="CourseID" />
       <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
       <ScalarProperty Name="Credits" ColumnName="Credits" />
       <ScalarProperty Name="Title" ColumnName="Title" />
     </MappingFragment>
   </EntityTypeMapping>
   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel1.OnlineCourse)">
     <MappingFragment StoreEntitySet="OnlineCourse">
       <ScalarProperty Name="CourseID" ColumnName="CourseID" />
       <ScalarProperty Name="URL" ColumnName="URL" />
     </MappingFragment>
   </EntityTypeMapping>
   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel1.OnsiteCourse)">
     <MappingFragment StoreEntitySet="OnsiteCourse">
       <ScalarProperty Name="CourseID" ColumnName="CourseID" />
       <ScalarProperty Name="Time" ColumnName="Time" />
       <ScalarProperty Name="Days" ColumnName="Days" />
       <ScalarProperty Name="Location" ColumnName="Location" />
     </MappingFragment>
   </EntityTypeMapping>
 </EntitySetMapping>

EntityTypeMapping 項目 (MSL)

對應規格語言中的 EntityTypeMapping 專案會定義概念模型中實體類型與基礎資料庫中資料表或檢視之間的對應。 如需概念模型實體類型和基礎資料庫資料表或檢視的詳細資訊，請參閱 EntityType 元素 （CSDL） 和 EntitySet 元素 （SSDL）。 正在對應的概念模型實體類型是由 EntityTypeMapping 專案的 TypeName 屬性 所指定。 所對應的資料表或檢視是由 子 MappingFragment 元素的 StoreEntitySet 屬性所指定。

ModificationFunctionMapping 子專案可用來將實體類型的插入、更新或刪除函式對應至資料庫中的預存程式。

EntityTypeMapping 元素可以有下列子項目：

  • MappingFragment （零個或多個）
  • ModificationFunctionMapping （零或一個）
  • ScalarProperty
  • 條件

注意

MappingFragment 和 ModificationFunctionMapping 元素不能同時是 EntityTypeMapping 專案的子項目 。

注意

ScalarProperty 和 Condition 元素只能在 FunctionImportMapping 元素內使用 EntityTypeMapping 元素的 子項目。

適用屬性

下表描述可套用至 EntityTypeMapping 元素的屬性。

屬性名稱 是必要的 值
TypeName Yes 要對應的概念模型實體類型之命名空間限定名稱。
如果型別是抽象型別或衍生型別，值必須是 IsOfType(Namespace-qualified_type_name)。

範例

下列範例顯示具有兩個子 EntityTypeMapping 元素的 EntitySetMapping 元素。 在第一個 EntityTypeMapping 元素中 ，SchoolModel.Person 實體類型會對應至 Person 資料表。 在第二個 EntityTypeMapping 元素中，SchoolModel.Person 類型的更新功能 會對應至資料庫中的預存程式 UpdatePerson 。

 <EntitySetMapping Name="People">
   <EntityTypeMapping TypeName="SchoolModel.Person">
     <MappingFragment StoreEntitySet="Person">
       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
       <ScalarProperty Name="LastName" ColumnName="LastName" />
       <ScalarProperty Name="FirstName" ColumnName="FirstName" />
       <ScalarProperty Name="HireDate" ColumnName="HireDate" />
       <ScalarProperty Name="EnrollmentDate" ColumnName="EnrollmentDate" />
     </MappingFragment>
   </EntityTypeMapping>
   <EntityTypeMapping TypeName="SchoolModel.Person">
     <ModificationFunctionMapping>
       <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>
     </ModificationFunctionMapping>
   </EntityTypeMapping>
 </EntitySetMapping>

範例

下一個範例會顯示型別階層的對應，在該階層內根型別是抽象型別。 請注意 TypeName 屬性的 IsOfType 語法 用法。

 <EntitySetMapping Name="People">
   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel.Person)">
     <MappingFragment StoreEntitySet="Person">
       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
       <ScalarProperty Name="FirstName" ColumnName="FirstName" />
       <ScalarProperty Name="LastName" ColumnName="LastName" />
     </MappingFragment>
   </EntityTypeMapping>
   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel.Instructor)">
     <MappingFragment StoreEntitySet="Person">
       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
       <ScalarProperty Name="HireDate" ColumnName="HireDate" />
       <Condition ColumnName="HireDate" IsNull="false" />
       <Condition ColumnName="EnrollmentDate" IsNull="true" />
     </MappingFragment>
   </EntityTypeMapping>
   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel.Student)">
     <MappingFragment StoreEntitySet="Person">
       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
       <ScalarProperty Name="EnrollmentDate"
                       ColumnName="EnrollmentDate" />
       <Condition ColumnName="EnrollmentDate" IsNull="false" />
       <Condition ColumnName="HireDate" IsNull="true" />
     </MappingFragment>
   </EntityTypeMapping>
 </EntitySetMapping>

FunctionImportMapping 項目 (MSL)

對應規格語言中的 FunctionImportMapping 專案會定義概念模型中函數匯入與基礎資料庫中預存程式或函式之間的對應。 函式匯入必須在概念模型中宣告，而預存程序則必須在儲存體模型中宣告。 如需詳細資訊，請參閱 FunctionImport 元素 （CSDL） 和 Function 元素 （SSDL）。

注意

根據預設，如果函式匯入傳回概念模型實體類型或複雜型別，則基礎預存程序所傳回的資料行名稱必須與概念模型類型上的屬性名稱完全相符。 如果資料行名稱與屬性名稱不完全相符，則必須在 ResultMapping 元素中定義對應。

FunctionImportMapping 元素可以有下列子項目：

  • ResultMapping （零個或多個）

適用屬性

下表描述適用于 FunctionImportMapping 元素的屬性：

屬性名稱 是必要的 值
FunctionImportName Yes 概念模型中要對應的函式匯入名稱。
FunctionName Yes 儲存體模型中要對應的函式之命名空間限定名稱。

範例

下列範例是以學校模型為基礎。 請考量儲存體模型中的下列函式：

 <Function Name="GetStudentGrades" Aggregate="false"
           BuiltIn="false" NiladicFunction="false"
           IsComposable="false" ParameterTypeSemantics="AllowImplicitConversion"
           Schema="dbo">
   <Parameter Name="StudentID" Type="int" Mode="In" />
 </Function>

同時考量概念模型中的這個函式匯入：

 <FunctionImport Name="GetStudentGrades" EntitySet="StudentGrades"
                 ReturnType="Collection(SchoolModel.StudentGrade)">
   <Parameter Name="StudentID" Mode="In" Type="Int32" />
 </FunctionImport>

下列範例顯示 FunctionImportMapping 元素，用來將上述函式和函式匯入對應至彼此：

 <FunctionImportMapping FunctionImportName="GetStudentGrades"
                        FunctionName="SchoolModel.Store.GetStudentGrades" />

 

InsertFunction 項目 (MSL)

對應規格語言 （MSL） 中的 InsertFunction 元素會將概念模型中實體類型或關聯之插入函式對應至基礎資料庫中的預存程式。 修改函式所對應的預存程序必須在儲存體模型中宣告。 如需詳細資訊，請參閱 Function 元素 （SSDL）。

注意

如果您未將實體類型的所有三個插入、更新或刪除作業對應至預存程式，則如果在執行時間執行且擲回 UpdateException，則未對應的作業將會失敗。

InsertFunction 元素可以是 ModificationFunctionMapping 元素的子系，並套用至 EntityTypeMapping 元素或 AssociationSetMapping 元素。

套用至 EntityTypeMapping 的 InsertFunction

套用至 EntityTypeMapping 元素時， InsertFunction 元素會將概念模型中實體類型的 insert 函式對應至預存程式。

InsertFunction 元素在套用至 EntityTypeMapping 元素時，可以有下列子項目：

  • AssociationEnd （零個或多個）
  • ComplexProperty （零個或多個）
  • ResultBinding （零或一個）
  • ScalarProperty （零個或多個）

適用屬性

下表描述套用至 EntityTypeMapping 專案時可套用至 InsertFunction 元素的屬性。

屬性名稱 是必要的 值
FunctionName Yes 插入函式所對應至之預存程序的命名空間限定名稱。 預存程序必須已宣告於儲存模型中。
RowsAffectedParameter No 會傳回受影響之資料列數的輸出參數名稱。

範例

下列範例是以 School 模型為基礎，並顯示 InsertFunction 元素，用來將 Person 實體類型的 insert 函式對應至 InsertPerson 預存程式。 InsertPerson 預存程式會在儲存體模型中宣告。

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

套用至 AssociationSetMapping 的 InsertFunction

當套用至 AssociationSetMapping 元素時， InsertFunction 元素會將概念模型中關聯之 insert 函式對應至預存程式。

當套用至 AssociationSetMapping 元素時，InsertFunction 元素可以有下列子項目：

  • EndProperty

適用屬性

下表描述當套用至 AssociationSetMapping 元素時，可以套用至 InsertFunction 元素的屬性。

屬性名稱 是必要的 值
FunctionName Yes 插入函式所對應至之預存程序的命名空間限定名稱。 預存程序必須已宣告於儲存模型中。
RowsAffectedParameter No 會傳回受影響之資料列數的輸出參數名稱。

範例

下列範例是以 School 模型為基礎，並顯示 用來將 CourseInstructor 關聯之 Insert 函式的 InsertFunction 元素對應至 InsertCourseInstructor 預存程式。 InsertCourseInstructor 預存程式會在儲存體模型中宣告。

 <AssociationSetMapping Name="CourseInstructor"
                        TypeName="SchoolModel.CourseInstructor"
                        StoreEntitySet="CourseInstructor">
   <EndProperty Name="Person">
     <ScalarProperty Name="PersonID" ColumnName="PersonID" />
   </EndProperty>
   <EndProperty Name="Course">
     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
   </EndProperty>
   <ModificationFunctionMapping>
     <InsertFunction FunctionName="SchoolModel.Store.InsertCourseInstructor" >   
       <EndProperty Name="Course">
         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
       </EndProperty>
       <EndProperty Name="Person">
         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
       </EndProperty>
     </InsertFunction>
     <DeleteFunction FunctionName="SchoolModel.Store.DeleteCourseInstructor">
       <EndProperty Name="Course">
         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
       </EndProperty>
       <EndProperty Name="Person">
         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
       </EndProperty>
     </DeleteFunction>
   </ModificationFunctionMapping>
 </AssociationSetMapping>

Mapping 項目 (MSL)

對應 規格語言 （MSL） 中的 Mapping 元素包含將概念模型中定義的物件對應至資料庫的資訊（如儲存模型中所述）。 如需詳細資訊，請參閱 CSDL 規格和 SSDL 規格。

Mapping 元素是對應規格的根項目。 對應規格的 XML 命名空間為 https://schemas.microsoft.com/ado/2009/11/mapping/cs 。

對應項目可以擁有下列子項目 (依列出的順序)：

  • 別名 （零個或多個）
  • EntityContainerMapping （正好一個）

MSL 中所參考之概念及儲存模型類型的名稱必須以它們各自的命名空間名稱來限定。 如需概念模型命名空間名稱的相關資訊，請參閱 Schema Element （CSDL）。 如需儲存體模型命名空間名稱的相關資訊，請參閱 Schema Element （SSDL）。 MSL 中使用的命名空間別名可以使用 Alias 元素來定義。

適用屬性

下表描述可套用至 Mapping 元素的屬性。

屬性名稱 是必要的 值
Space Yes C-S . 這是固定值，無法變更。

範例

下列範例顯示以 學校模型的一部分為基礎的 Mapping 元素。 如需學校模型的詳細資訊，請參閱快速入門（Entity Framework）：

 <Mapping Space="C-S"
          xmlns="https://schemas.microsoft.com/ado/2009/11/mapping/cs">
   <Alias Key="c" Value="SchoolModel"/>
   <EntityContainerMapping StorageEntityContainer="SchoolModelStoreContainer"
                           CdmEntityContainer="SchoolModelEntities">
     <EntitySetMapping Name="Courses">
       <EntityTypeMapping TypeName="c.Course">
         <MappingFragment StoreEntitySet="Course">
           <ScalarProperty Name="CourseID" ColumnName="CourseID" />
           <ScalarProperty Name="Title" ColumnName="Title" />
           <ScalarProperty Name="Credits" ColumnName="Credits" />
           <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
         </MappingFragment>
       </EntityTypeMapping>
     </EntitySetMapping>
     <EntitySetMapping Name="Departments">
       <EntityTypeMapping TypeName="c.Department">
         <MappingFragment StoreEntitySet="Department">
           <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
           <ScalarProperty Name="Name" ColumnName="Name" />
           <ScalarProperty Name="Budget" ColumnName="Budget" />
           <ScalarProperty Name="StartDate" ColumnName="StartDate" />
           <ScalarProperty Name="Administrator" ColumnName="Administrator" />
         </MappingFragment>
       </EntityTypeMapping>
     </EntitySetMapping>
   </EntityContainerMapping>
 </Mapping>

MappingFragment 項目 (MSL)

對應規格語言 （MSL） 中的 MappingFragment 元素會定義概念模型實體類型和資料庫中資料表或檢視表的屬性之間的對應。 如需概念模型實體類型和基礎資料庫資料表或檢視的詳細資訊，請參閱 EntityType 元素 （CSDL） 和 EntitySet 元素 （SSDL）。 MappingFragment 可以是 EntityTypeMapping 元素或 EntitySetMapping 專案的子專案。

MappingFragment 元素可以有下列子項目：

  • ComplexType （零個或多個）
  • ScalarProperty （零個或多個）
  • 條件 （零個或多個）

適用屬性

下表描述可套用至 MappingFragment 元素的屬性。

屬性名稱 是必要的 值
StoreEntitySet Yes 要對應的資料表或檢視之名稱。
MakeColumnsDistinct No True 或 False ，視是否只傳回相異資料列而定。
如果此屬性設定為 True ， EntityContainerMapping 專案的 GenerateUpdateViews 屬性必須設定為 False 。

範例

下列範例顯示 MappingFragment 元素做為 EntityTypeMapping 專案的子 系。 在此範例中，概念模型中 Course 類型的屬性 會對應至資料庫中 Course 資料表的資料 行。

 <EntitySetMapping Name="Courses">
   <EntityTypeMapping TypeName="SchoolModel.Course">
     <MappingFragment StoreEntitySet="Course">
       <ScalarProperty Name="CourseID" ColumnName="CourseID" />
       <ScalarProperty Name="Title" ColumnName="Title" />
       <ScalarProperty Name="Credits" ColumnName="Credits" />
       <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
     </MappingFragment>
   </EntityTypeMapping>
 </EntitySetMapping>

範例

下列範例顯示 MappingFragment 元素做為 EntitySetMapping 專案的子 系。 如上述範例所示，概念模型中 Course 類型的屬性 會對應至資料庫中 Course 資料表的資料 行。

 <EntitySetMapping Name="Courses" TypeName="SchoolModel.Course">
     <MappingFragment StoreEntitySet="Course">
       <ScalarProperty Name="CourseID" ColumnName="CourseID" />
       <ScalarProperty Name="Title" ColumnName="Title" />
       <ScalarProperty Name="Credits" ColumnName="Credits" />
       <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
     </MappingFragment>
 </EntitySetMapping>

ModificationFunctionMapping 屬性 (MSL)

Mapping specification language （MSL） 中的 ModificationFunctionMapping 元素會將概念模型實體類型的插入、更新和刪除函式對應至基礎資料庫中的預存程式。 ModificationFunctionMapping 元素也可以將概念模型中多對多關聯的插入和刪除函式對應至基礎資料庫中的預存程式。 修改函式所對應的預存程序必須在儲存體模型中宣告。 如需詳細資訊，請參閱 Function 元素 （SSDL）。

注意

如果您未將實體類型的所有三個插入、更新或刪除作業對應至預存程式，則如果在執行時間執行且擲回 UpdateException，則未對應的作業將會失敗。

注意

如果繼承階層架構中某個實體的修改函式已對應至預存程序，則階層架構中所有類型的修改函式都必須對應至預存程序。

ModificationFunctionMapping 元素可以是 EntityTypeMapping 元素或 AssociationSetMapping 專案的子系。

ModificationFunctionMapping 元素可以有下列子項目：

  • DeleteFunction （零或一個）
  • InsertFunction （零或一個）
  • UpdateFunction （零或一個）

任何屬性都不適用於 ModificationFunctionMapping 專案。

範例

下列範例顯示學校模型中人員 實體集的 實體集對應。 除了 Person 實體類型的資料行對應 之外，也會顯示 Person 類型的插入、更新和刪除函式的 對應。 對應至的函式會在儲存體模型中宣告。

 <EntitySetMapping Name="People">
   <EntityTypeMapping TypeName="SchoolModel.Person">
     <MappingFragment StoreEntitySet="Person">
       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
       <ScalarProperty Name="LastName" ColumnName="LastName" />
       <ScalarProperty Name="FirstName" ColumnName="FirstName" />
       <ScalarProperty Name="HireDate" ColumnName="HireDate" />
       <ScalarProperty Name="EnrollmentDate"
                       ColumnName="EnrollmentDate" />
     </MappingFragment>
 </EntityTypeMapping>
   <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>
 </EntitySetMapping>

範例

下列範例顯示 School 模型中 CourseInstructor 關聯集的關聯集對應 。 除了 CourseInstructor 關聯的資料行對應 之外，也會顯示 CourseInstructor 關聯之 insert 和 delete 函式的 對應。 對應至的函式會在儲存體模型中宣告。

 <AssociationSetMapping Name="CourseInstructor"
                        TypeName="SchoolModel.CourseInstructor"
                        StoreEntitySet="CourseInstructor">
   <EndProperty Name="Person">
     <ScalarProperty Name="PersonID" ColumnName="PersonID" />
   </EndProperty>
   <EndProperty Name="Course">
     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
   </EndProperty>
   <ModificationFunctionMapping>
     <InsertFunction FunctionName="SchoolModel.Store.InsertCourseInstructor" >   
       <EndProperty Name="Course">
         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
       </EndProperty>
       <EndProperty Name="Person">
         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
       </EndProperty>
     </InsertFunction>
     <DeleteFunction FunctionName="SchoolModel.Store.DeleteCourseInstructor">
       <EndProperty Name="Course">
         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
       </EndProperty>
       <EndProperty Name="Person">
         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
       </EndProperty>
     </DeleteFunction>
   </ModificationFunctionMapping>
 </AssociationSetMapping>

 

 

QueryView 項目 (MSL)

對應規格語言中的 QueryView 元素會定義概念模型中實體類型或關聯與基礎資料庫中資料表之間的唯讀對應。 對應是以根據儲存體模型評估的 Entity SQL 查詢來定義，而您會以概念模型中的實體或關聯來表示結果集。 因為查詢檢視是唯讀的，無法使用標準更新命令來更新查詢檢視所定義的類型。 您可以使用修改函式來更新這些類型。 如需詳細資訊，請參閱如何：將修改函式對應至預存程式。

注意

在 QueryView 元素中 ，不支援包含 GroupBy 、群組匯總或導覽屬性的 Entity SQL 運算式。

 

QueryView 元素可以是 EntitySetMapping 元素或 AssociationSetMapping 專案的子系。 若是前者，查詢檢視會定義概念模型中之實體的唯讀對應。 若是後者，查詢檢視會定義概念模型中之關聯的唯讀對應。

注意

如果 AssociationSetMapping 元素用於與引用條件約束的關聯， 則會忽略 AssociationSetMapping 元素。 如需詳細資訊，請參閱 ReferentialConstraint 元素 （CSDL）。

QueryView 元素不能有任何子專案。

適用屬性

下表描述可套用至 QueryView 元素的屬性。

屬性名稱 是必要的 值
TypeName No 要由查詢檢視對應的概念模型類型名稱。

範例

下列範例顯示 QueryView 元素做為 EntitySetMapping 元素的 子系，並定義 School Model 中 Department 實體類型的查詢檢視對應 。 

 <EntitySetMapping Name="Departments" >
   <QueryView>
     SELECT VALUE SchoolModel.Department(d.DepartmentID,
                                         d.Name,
                                         d.Budget,
                                         d.StartDate)
     FROM SchoolModelStoreContainer.Department AS d
     WHERE d.Budget > 150000
   </QueryView>
 </EntitySetMapping>

由於查詢只會傳回儲存體模型中 Department 類型成員的 子集， 因此學校模型中的 Department 類型已根據此對應修改，如下所示：

 <EntityType Name="Department">
   <Key>
     <PropertyRef Name="DepartmentID" />
   </Key>
   <Property Type="Int32" Name="DepartmentID" Nullable="false" />
   <Property Type="String" Name="Name" Nullable="false"
             MaxLength="50" FixedLength="false" Unicode="true" />
   <Property Type="Decimal" Name="Budget" Nullable="false"
             Precision="19" Scale="4" />
   <Property Type="DateTime" Name="StartDate" Nullable="false" />
   <NavigationProperty Name="Courses"
                       Relationship="SchoolModel.FK_Course_Department"
                       FromRole="Department" ToRole="Course" />
 </EntityType>

範例

下一個 範例顯示 QueryView 元素做為 AssociationSetMapping 元素的子系，並在 School 模型中定義關聯唯讀 FK_Course_Department 對應。

 <EntityContainerMapping StorageEntityContainer="SchoolModelStoreContainer"
                         CdmEntityContainer="SchoolEntities">
   <EntitySetMapping Name="Courses" >
     <QueryView>
       SELECT VALUE SchoolModel.Course(c.CourseID,
                                       c.Title,
                                       c.Credits)
       FROM SchoolModelStoreContainer.Course AS c
     </QueryView>
   </EntitySetMapping>
   <EntitySetMapping Name="Departments" >
     <QueryView>
       SELECT VALUE SchoolModel.Department(d.DepartmentID,
                                           d.Name,
                                           d.Budget,
                                           d.StartDate)
       FROM SchoolModelStoreContainer.Department AS d
       WHERE d.Budget > 150000
     </QueryView>
   </EntitySetMapping>
   <AssociationSetMapping Name="FK_Course_Department" >
     <QueryView>
       SELECT VALUE SchoolModel.FK_Course_Department(
         CREATEREF(SchoolEntities.Departments, row(c.DepartmentID), SchoolModel.Department),
         CREATEREF(SchoolEntities.Courses, row(c.CourseID)) )
       FROM SchoolModelStoreContainer.Course AS c
     </QueryView>
   </AssociationSetMapping>
 </EntityContainerMapping>

 

註解

您可以定義查詢檢視來啟用下列案例：

  • 定義概念模型中的實體，其中未包含儲存體模型中實體的所有屬性。 這包括沒有預設值且不支援 Null 值的屬性。
  • 將儲存體模型中的計算資料行對應至概念模型中實體類型的屬性。
  • 定義分割概念模型實體所用之條件不是以實體為依據的對應。 當您使用 Condition 元素指定條件對應時，提供的條件必須等於指定的值。 如需詳細資訊，請參閱 Condition 元素 （MSL）。
  • 將儲存體模型中的相同資料行對應至概念模型中的多種類型。
  • 將多種類型對應至相同資料表。
  • 定義概念模型中不是以關聯式結構描述之外部索引鍵為依據的關聯。
  • 使用自訂商務邏輯來設定概念模型中的屬性值。 例如，您可以將資料來源中的字串值 「T」 對應至 概念模型中的 true 值布林值。
  • 為查詢結果定義條件篩選器。
  • 對概念模型資料強加的限制比儲存體模型的少。 例如，即使所對應的資料行不支援 Null 值，您還是可以將概念模型中的屬性設為可為 Null 。

下列考量適用於為實體定義查詢檢視的情況：

  • 查詢檢視是唯讀的。 您只能使用修改函式來更新這些實體。
  • 當您依據查詢檢視定義實體類型時，也必須依據查詢檢視定義所有的相關實體。
  • 當您將多對多關聯對應至儲存體模型中代表關係架構中連結資料表的實體時，您必須在此連結資料表的 AssociationSetMapping 元素中定義 QueryView 元素。
  • 必須為類型階層架構中的所有類型定義查詢檢視。 您可以透過下列方法完成這項作業：
    • 使用單 一 QueryView 元素，指定單一 Entity SQL 查詢，以傳回階層中所有實體類型的聯集。
    • 使用單 一 QueryView 元素，指定單一 Entity SQL 查詢，該查詢會使用 CASE 運算子，根據特定條件傳回階層中的特定實體類型。
    • 使用階層中特定類型的其他 QueryView 元素。 在此情況下，請使用 QueryView 元素的 TypeName 屬性來指定每個檢視的實體類型。
  • 定義查詢檢視時，您無法在 EntitySetMapping 元素上 指定 儲存體SetName 屬性。
  • 定義查詢檢視時， EntitySetMapping 元素不能也包含 屬性 對應。

ResultBinding 項目 (MSL)

對應 規格語言 （MSL） 中的 ResultBinding 元素會將預存程式傳回的資料行值對應至概念模型中的實體屬性時，實體類型修改函式對應至基礎資料庫中的預存程式。 例如，當插入預存程式傳回識別欄位的值時， ResultBinding 元素會將傳回的值對應至概念模型中的實體類型屬性。

ResultBinding 元素可以是 InsertFunction 元素或 UpdateFunction 專案的子系。

ResultBinding 元素不能有任何子專案。

適用屬性

下表描述適用于 ResultBinding 元素的屬性：

屬性名稱 是必要的 值
名稱 Yes 概念模型中要對應之實體屬性的名稱。
ColumnName Yes 要對應的資料行名稱。

範例

下列範例是以 School 模型為基礎，並顯示 InsertFunction 元素，用來將 Person 實體類型的 insert 函式對應至 InsertPerson 預存程式。 （The InsertPerson 預存程式如下所示，並在儲存體模型中宣告。ResultBinding 元素可用來將預存程式 （ NewPersonID） 傳回的資料行值對應至實體類型屬性 （ PersonID ）。

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

下列 Transact-SQL 描述 InsertPerson 預存程式：

 CREATE PROCEDURE [dbo].[InsertPerson]
                                @LastName nvarchar(50),
                                @FirstName nvarchar(50),
                                @HireDate datetime,
                                @EnrollmentDate datetime
                                AS
                                INSERT INTO dbo.Person (LastName,
                                                                             FirstName,
                                                                             HireDate,
                                                                             EnrollmentDate)
                                VALUES (@LastName,
                                               @FirstName,
                                               @HireDate,
                                               @EnrollmentDate);
                                SELECT SCOPE_IDENTITY() as NewPersonID;

ResultMapping 項目 (MSL)

對應規格語言中的 ResultMapping 元素會定義概念模型中的函式匯入與基礎資料庫中預存程式之間的對應，如下列為 true：

  • 函式匯入會傳回概念模型實體類型或複雜型別。
  • 預存程序所傳回之資料行名稱未與實體類型或複雜型別上的屬性名稱完全相符。

根據預設，預存程序所傳回之資料行與實體類型或複雜型別間的對應是以資料行和屬性名稱為基礎。 如果資料行名稱與屬性名稱不完全相符，您必須使用 ResultMapping 元素來定義對應。 如需預設對應的範例，請參閱 FunctionImportMapping 元素 （MSL）。

ResultMapping 元素是 FunctionImportMapping 專案的子專案。

ResultMapping 元素可以有下列子項目：

  • EntityTypeMapping （零個或多個）
  • ComplexTypeMapping

沒有任何屬性適用于 ResultMapping 元素。

範例

請考慮下列預存程序：

 CREATE PROCEDURE [dbo].[GetGrades]
             @student_Id int
             AS
             SELECT     EnrollmentID as enroll_id,
                                                                             Grade as grade,
                                                                             CourseID as course_id,
                                                                             StudentID as student_id
                                               FROM dbo.StudentGrade
             WHERE StudentID = @student_Id

同時請考慮下列概念模型實體類型：

 <EntityType Name="StudentGrade">
   <Key>
     <PropertyRef Name="EnrollmentID" />
   </Key>
   <Property Name="EnrollmentID" Type="Int32" Nullable="false"
             annotation:StoreGeneratedPattern="Identity" />
   <Property Name="CourseID" Type="Int32" Nullable="false" />
   <Property Name="StudentID" Type="Int32" Nullable="false" />
   <Property Name="Grade" Type="Decimal" Precision="3" Scale="2" />
 </EntityType>

若要建立傳回先前實體類型的實例的函式匯入，預存程式和實體類型所傳回之資料行之間的對應必須在 ResultMapping 元素中 定義：

 <FunctionImportMapping FunctionImportName="GetGrades"
                        FunctionName="SchoolModel.Store.GetGrades" >
   <ResultMapping>
     <EntityTypeMapping TypeName="SchoolModel.StudentGrade">
       <ScalarProperty Name="EnrollmentID" ColumnName="enroll_id"/>
       <ScalarProperty Name="CourseID" ColumnName="course_id"/>
       <ScalarProperty Name="StudentID" ColumnName="student_id"/>
       <ScalarProperty Name="Grade" ColumnName="grade"/>
     </EntityTypeMapping>
   </ResultMapping>
 </FunctionImportMapping>

ScalarProperty 項目 (MSL)

對應規格語言 （MSL） 中的 ScalarProperty 元素會將概念模型實體類型、複雜類型或關聯上的屬性對應至基礎資料庫中的資料表資料行或預存程式參數。

注意

修改函式所對應的預存程序必須在儲存體模型中宣告。 如需詳細資訊，請參閱 Function 元素 （SSDL）。

ScalarProperty 元素可以是下列專案的子系：

  • MappingFragment
  • InsertFunction
  • UpdateFunction
  • DeleteFunction
  • EndProperty
  • ComplexProperty
  • ResultMapping

ScalarProperty 元素是 MappingFragment 、ComplexProperty 或 EndProperty 元素的 子系， 會將概念模型中的屬性對應至資料庫中的資料 行。 作為 InsertFunction 、UpdateFunction 或 DeleteFunction 元素的 子系， ScalarProperty 元素會將概念模型中的屬性對應至預存程式 參數。

ScalarProperty 元素不能有任何子專案。

適用屬性

套用至 ScalarProperty 元素的屬性會根據專案的角色而有所不同。

下表描述當 ScalarProperty 元素用來將概念模型屬性對應至資料庫中資料行時 適用的屬性：

屬性名稱 是必要的 值
名稱 Yes 要對應的概念模型屬性名稱。
ColumnName Yes 要對應的資料表資料行名稱。

下表描述 當它用來將概念模型屬性對應至預存程式參數時，適用于 ScalarProperty 元素的屬性：

屬性名稱 是必要的 值
名稱 Yes 要對應的概念模型屬性名稱。
ParameterName Yes 要對應的參數名稱。
版本 No 目前 或 原始 取決於屬性的目前值或原始值是否應該用於並行檢查。

範例

下列範例顯示 以兩種方式使用的 ScalarProperty 元素：

  • 若要將 Person 實體類型的屬性 對應至 Person 資料表的資料 行。
  • 若要將 Person 實體類型的屬性 對應至 UpdatePerson 預存程式的參數 。 預存程序已宣告於儲存模型中。
 <EntitySetMapping Name="People">
   <EntityTypeMapping TypeName="SchoolModel.Person">
     <MappingFragment StoreEntitySet="Person">
       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
       <ScalarProperty Name="LastName" ColumnName="LastName" />
       <ScalarProperty Name="FirstName" ColumnName="FirstName" />
       <ScalarProperty Name="HireDate" ColumnName="HireDate" />
       <ScalarProperty Name="EnrollmentDate"
                       ColumnName="EnrollmentDate" />
     </MappingFragment>
 </EntityTypeMapping>
   <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>
 </EntitySetMapping>

範例

下一個範例顯示 ScalarProperty 元素，用來將概念模型關聯之插入和刪除函式對應至資料庫中的預存程式。 預存程序已宣告於儲存模型中。

 <AssociationSetMapping Name="CourseInstructor"
                        TypeName="SchoolModel.CourseInstructor"
                        StoreEntitySet="CourseInstructor">
   <EndProperty Name="Person">
     <ScalarProperty Name="PersonID" ColumnName="PersonID" />
   </EndProperty>
   <EndProperty Name="Course">
     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
   </EndProperty>
   <ModificationFunctionMapping>
     <InsertFunction FunctionName="SchoolModel.Store.InsertCourseInstructor" >   
       <EndProperty Name="Course">
         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
       </EndProperty>
       <EndProperty Name="Person">
         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
       </EndProperty>
     </InsertFunction>
     <DeleteFunction FunctionName="SchoolModel.Store.DeleteCourseInstructor">
       <EndProperty Name="Course">
         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
       </EndProperty>
       <EndProperty Name="Person">
         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
       </EndProperty>
     </DeleteFunction>
   </ModificationFunctionMapping>
 </AssociationSetMapping>

UpdateFunction 項目 (MSL)

對應規格語言 （MSL） 中的 UpdateFunction 元素會將概念模型中實體類型的 update 函式對應至基礎資料庫中的預存程式。 修改函式所對應的預存程序必須在儲存體模型中宣告。 如需詳細資訊，請參閱 Function 元素 （SSDL）。

注意

如果您未將實體類型的所有三個插入、更新或刪除作業對應至預存程式，則如果在執行時間執行且擲回 UpdateException，則未對應的作業將會失敗。

UpdateFunction 元素可以是 ModificationFunctionMapping 元素的子系，並套用至 EntityTypeMapping 元素。

UpdateFunction 元素可以有下列子項目：

  • AssociationEnd （零個或多個）
  • ComplexProperty （零個或多個）
  • ResultBinding （零或一個）
  • ScalarProperty （零個或多個）

適用屬性

下表描述可套用至 UpdateFunction 元素的屬性。

屬性名稱 是必要的 值
FunctionName Yes 更新函式所對應至之預存程序的命名空間限定名稱。 預存程序必須已宣告於儲存模型中。
RowsAffectedParameter No 會傳回受影響之資料列數的輸出參數名稱。

範例

下列範例是以 School 模型為基礎，並顯示 UpdateFunction 元素，用來將 Person 實體類型的 update 函式對應至 UpdatePerson 預存程式。 UpdatePerson 預存程式會在儲存體模型中宣告。

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