End 요소(CSDL)

CSDL(개념 스키마 정의 언어)의 End 요소는 Association 요소 또는 AssociationSet 요소의 자식일 수 있습니다. 각 경우에서 End 요소의 역할과 적용 가능한 특성은 서로 다릅니다.

Association 요소의 자식인 End 요소

Association 요소의 자식인 End 요소는 연결의 한 End에 있는 엔터티 형식과 연결의 해당 End에 있을 수 있는 엔터티 형식 인스턴스 수를 식별합니다. 연결 End는 연결의 일부로 정의되고 연결에는 정확히 두 개의 연결 End가 있어야 합니다. 연결의 한 End에 있는 엔터티 형식 인스턴스는 엔터티 형식에서 노출된 경우 탐색 속성 또는 외래 키를 통해 액세스할 수 있습니다. 자세한 내용은 NavigationProperty 요소, ReferentialConstraint 요소 및 관계 정의 및 관리(Entity Framework)를 참조하십시오.

End 요소는 다음에 나열된 순서대로 자식 요소를 포함할 수 있습니다.

• Documentation(0개 또는 한 개의 요소)

• OnDelete(0개 또는 한 개의 요소)

• Annotation 요소(0개 이상의 요소)

적용 가능한 특성

다음 표에서는 Association 요소의 자식인 경우 End 요소에 적용할 수 있는 특성에 대해 설명합니다.

특성 이름	필수 여부	값
Type	예	연결의 한 End에 있는 엔터티 형식의 이름
Role	아니요	연결 End의 이름. 이름을 지정하지 않으면 연결 End에 있는 엔터티 형식의 이름이 사용됩니다.
Multiplicity	예	연결 End에 있을 수 있는 엔터티 형식 인스턴스 수에 따라 1, 0..1 또는 * 1은 연결 End에 엔터티 형식 인스턴스가 정확히 한 개 있음을 나타냅니다. 0..1은 연결 End에 엔터티 형식 인스턴스가 0개 또는 한 개 있음을 나타냅니다. *는 연결 End에 엔터티 형식 인스턴스가 0개 또는 한 개 이상 있음을 나타냅니다.

참고:
주석 특성(사용자 지정 XML 특성)을 원하는 수만큼 End 요소에 적용할 수 있습니다.그러나 사용자 지정 특성은 CSDL에 예약된 XML 네임스페이스에 속할 수 없습니다.두 사용자 지정 특성의 정규화된 이름은 서로 같을 수 없습니다.

예제

다음 예제에서는 CustomerOrders 연결을 정의하는 Association 요소를 보여 줍니다. 연결의 각 End에 대한 Multiplicity 값은 많은 Orders가 한 Customer에 연결될 수 있지만 한 Order에는 하나의 Customer만 연결할 수 있음을 나타냅니다. 또한 OnDelete 요소는 Customer를 삭제할 경우 특정 Customer와 관련되고 ObjectContext로 로드된 모든 Orders가 삭제됨을 나타냅니다.

<Association Name="CustomerOrders">
  <End Type="ExampleModel.Customer" Role="Customer" Multiplicity="1" />
  <End Type="ExampleModel.Order" Role="Order" Multiplicity="*">
        <OnDelete Action="Cascade" />
  </End>
</Association>

AssociationSet 요소의 자식인 End 요소

End 요소는 연결 집합의 한 End를 지정합니다. AssociationSet 요소에는 두 개의 End 요소가 포함되어야 합니다. End 요소에 포함된 정보는 연결 집합을 데이터 소스에 매핑할 때 사용됩니다. 자세한 내용은 AssociationSetMapping 요소(MSL) 및 EndProperty 요소(MSL)를 참조하십시오.

End 요소는 다음에 나열된 순서대로 자식 요소를 포함할 수 있습니다.

• Documentation(0개 또는 한 개의 요소)

• Annotation 요소(0개 이상의 요소)

참고:
Annotation 요소는 다른 모든 자식 요소 뒤에 와야 합니다.Annotation 요소는 .NET Framework 버전 4 이상을 대상으로 하는 응용 프로그램에 대한 개념적 모델에서만 허용됩니다.이러한 모델에 대한 XML 네임스페이스는 https://schemas.microsoft.com/ado/2008/09/edm입니다.

적용 가능한 특성

다음 표에서는 AssociationSet 요소의 자식인 경우 End 요소에 적용할 수 있는 특성에 대해 설명합니다.

특성 이름	필수 여부	값
EntitySet	예	부모 AssociationSet 요소의 한 End를 정의하는 EntitySet 요소의 이름. EntitySet 요소는 부모 AssociationSet 요소와 동일한 엔터티 컨테이너에 정의되어 있어야 합니다.
Role	아니요	연결 집합 End의 이름. Role 특성을 사용하지 않으면 연결 집합 End의 이름이 엔터티 집합의 이름이 됩니다.

참고:
주석 특성(사용자 지정 XML 특성)을 원하는 수만큼 End 요소에 적용할 수 있습니다.그러나 사용자 지정 특성은 CSDL에 예약된 XML 네임스페이스에 속할 수 없습니다.두 사용자 지정 특성의 정규화된 이름은 서로 같을 수 없습니다.

예제

다음 예제에서는 각각 End 요소 두 개가 있는 AssociationSet 요소 두 개를 포함하는 EntityContainer 요소를 보여 줍니다.

<EntityContainer Name="BooksContainer" >
  <EntitySet Name="Books" EntityType="BooksModel.Book" />
  <EntitySet Name="Publishers" EntityType="BooksModel.Publisher" />
  <EntitySet Name="Authors" EntityType="BooksModel.Author" />
  <AssociationSet Name="PublishedBy" Association="BooksModel.PublishedBy">
    <End Role="Book" EntitySet="Books" />
    <End Role="Publisher" EntitySet="Publishers" />
  </AssociationSet>
  <AssociationSet Name="WrittenBy" Association="BooksModel.WrittenBy">
    <End Role="Book" EntitySet="Books" />
    <End Role="Author" EntitySet="Authors" />
  </AssociationSet>
</EntityContainer>

참고 항목

개념

Entity Framework 개요
CSDL 사양
Schema 요소(CSDL)
EntityContainer 요소(CSDL)

기타 리소스

CSDL, SSDL 및 MSL 사양
ADO.NET Entity Data Model Tools
association end (Entity Data Model)
association set (Entity Data Model)
association set end (Entity Data Model)