Principal 項目 (SSDL)

存放結構定義語言 (SSDL) 中的 Principal 項目是 ReferentialConstraint 項目的子項目，可定義外部索引鍵條件約束 (也稱為參考條件約束) 的主體端。 Principal 項目會指定資料表中供其他資料行參考的主要索引鍵資料行 (或多個資料行)。 PropertyRef 項目會指定參考哪些資料行。 Dependent 項目可指定參考 Principal 項目中所指定之主要索引鍵資料行的資料行。

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

• PropertyRef (一個或多個)

• Annotation 項目 (零或多個)

適用屬性

下表描述可套用至 Principal 項目的屬性。

屬性名稱	必要	值
Role	是	與對應之 End 項目的 Role 屬性 (若使用的話) 相同的值；否則就是包含參考資料行的資料表之名稱。

注意：
可以將任何數量的附註屬性 (自訂 XML 屬性) 套用至 Principal 項目。不過，自訂屬性不可屬於任何 XML 命名空間，這是保留供 CSDL 使用。任兩個自訂屬性的完整名稱不能相同。

範例

下列範例顯示 Association 項目，它會使用 ReferentialConstraint 項目來指定參與 FK_CustomerOrders 外部索引鍵條件約束之資料行。 Principal 項目會指定 Customer 資料表的 CustomerId 資料行做為條件約束的主體端。

<Association Name="FK_CustomerOrders">
  <End Role="Customers" 
       Type="ExampleModel.Store.Customers" Multiplicity="1">
    <OnDelete Action="Cascade" />
  </End>
  <End Role="Orders" 
       Type="ExampleModel.Store.Orders" Multiplicity="*" />
  <ReferentialConstraint>
    <Principal Role="Customers">
      <PropertyRef Name="CustomerId" />
    </Principal>
    <Dependent Role="Orders">
      <PropertyRef Name="CustomerId" />
    </Dependent>
  </ReferentialConstraint>
</Association>

另請參閱

概念

Entity Framework 概觀
SSDL 規格

其他資源

CSDL、SSDL 和 MSL 規格
ADO.NET Entity Data Model Tools