ScalarProperty 要素 (MSL)

マッピング仕様言語 (MSL) の ScalarProperty 要素は、概念モデルのエンティティ型、複合型、またはアソシエーションのプロパティを、基になるデータベースのテーブル列またはストアド プロシージャ パラメーターにマップします。

注 :
変更関数のマップ先であるストアド プロシージャは、ストレージ モデル内で宣言する必要があります。詳細については、「Function 要素 (SSDL)」を参照してください。

The ScalarProperty element can be a child of the following elements:

• MappingFragment

• InsertFunction

• UpdateFunction

• DeleteFunction

• EndProperty

• ComplexProperty

• ResultMapping

MappingFragment、ComplexProperty、または EndProperty 要素の子として、ScalarProperty 要素は概念モデルのプロパティをデータベースの列にマップします。 InsertFunction、UpdateFunction、または DeleteFunction 要素の子として、ScalarProperty 要素は概念モデルのプロパティをストアド プロシージャ パラメーターにマップします。

The ScalarProperty element cannot have any child elements.

適用可能な属性

ScalarProperty 要素に適用できる属性は、要素の役割によって異なります。

次の表で、ScalarProperty 要素を使用して概念モデルのプロパティをデータベースの列にマップしたときに適用可能な属性について説明します。

属性名	必須	Value
Name	有効	マップされる概念モデルのプロパティの名前。
ColumnName	有効	マップされるテーブル列の名前。

次の表で、ScalarProperty 要素を使用して概念モデルのプロパティをストアド プロシージャ パラメーターにマップしたときに適用可能な属性について説明します。

属性名	必須	Value
Name	有効	マップされる概念モデルのプロパティの名前。
ParameterName	有効	マップされるパラメーターの名前。
Version	いいえ	現在の値、またはプロパティの元の値を同時実行チェックに使用するかどうかにより、Current または Original。

例

次の例は ScalarProperty 要素を使用する 2 つの方法を示しています。

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

参照

その他のリソース

CSDL、SSDL、および MSL 仕様
モデリングとマッピング (Entity Framework)