Principal 要素 (CSDL)
概念スキーマ定義言語 (CSDL) の Principal 要素は、ReferentialConstraint 要素の子要素であり、参照制約のプリンシパル End を定義します。ReferentialConstraint 要素は、リレーショナル データベースの参照整合性制約と同様の機能を定義します。データベース テーブルの列が別のテーブルの主キーを参照できるのと同じように、エンティティ型のプロパティが別のエンティティ型のエンティティ キーを参照できます。参照されるエンティティ型は、制約のプリンシパル End と呼ばれます。プリンシパル End を参照するエンティティ型は、制約の依存 End と呼ばれます。PropertyRef 要素は、依存 End によって参照されるキーを指定するために使用されます。
Principal 要素には、次の子要素をここに示す順序で含めることができます。
PropertyRef (1 個以上の要素)
Annotation 要素 (0 個以上の要素)
適用可能な属性
Principal 要素に適用できる属性を次の表に示します。
属性名 |
必須 |
値 |
|---|---|---|
Role |
はい |
アソシエーションのプリンシパル End 上のエンティティ型の名前。 |
注意
Principal 要素には、任意の数の annotation 属性 (カスタム XML 属性) を適用できます。ただし、カスタム属性は CSDL 用に予約されたどの XML 名前空間にも属さない場合があります。カスタム属性の完全修飾名は一意である必要があります。
例
次の例は、PublishedBy アソシエーションの定義の一部である ReferentialConstraint 要素を示します。Publisher エンティティ型の Id プロパティは、参照制約のプリンシパル End を構成します。
<Association Name="PublishedBy">
<End Type="BooksModel.Book" Role="Book" Multiplicity="*" >
</End>
<End Type="BooksModel.Publisher" Role="Publisher" Multiplicity="1" />
<ReferentialConstraint>
<Principal Role="Publisher">
<PropertyRef Name="Id" />
</Principal>
<Dependent Role="Book">
<PropertyRef Name="PublisherId" />
</Dependent>
</ReferentialConstraint>
</Association>