AssociationSet-Element (CSDL)

Artikel
12/10/2012

Das AssociationSet-Element in der konzeptionellen Schemadefinitionssprache (CSDL) ist ein logischer Container für Zuordnungsinstanzen desselben Typs.Ein Zuordnungssatz stellt eine Definition zum Gruppieren von Zuordnungsinstanzen bereit, sodass sie einer Datenquelle zugeordnet werden können.Weitere Informationen zum Mapping finden Sie unter AssociationSetMapping-Element (MSL).

Das AssociationSet-Element kann die folgenden untergeordneten Elemente aufweisen (der vorliegenden Reihenfolge entsprechend):

Dokumentation (kein (null) oder ein Element zugelassen)
End (genau zwei Elemente erforderlich)
Anmerkungselemente (kein (null) Element oder mehrere Elemente zugelassen)

Das Association-Attribut gibt den Zuordnungstyp an, den ein Zuordnungssatz enthält.Die Entitätssätze, die die Enden eines Zuordnungssatzes bilden, werden genau mit zwei untergeordneten End-Elementen angegeben.

Anwendbare Attribute

In der folgenden Tabelle werden die Attribute beschrieben, die für das AssociationSet-Element übernommen werden können.

Attributname	Ist erforderlich	Wert
Name	Ja	Der Name des Entitätssatzes.Der Wert des Name-Attributs darf nicht mit dem Wert für das Association-Attribut übereinstimmen.
Association	Ja	Der vollqualifizierte Name der Zuordnung, von der der Zuordnungssatz Instanzen enthält.Die Zuordnung muss sich im gleichen Namespace wie der Zuordnungssatz befinden.

Hinweis

Eine beliebige Anzahl von Anmerkungsattributen (benutzerdefinierte XML-Attribute) kann für das AssociationSet-Element übernommen werden.Benutzerdefinierte Attribute dürfen jedoch zu keinem XML-Namespace gehören, der für CSDL reserviert ist.Die vollqualifizierten Namen für zwei benutzerdefinierte Attribute dürfen nicht übereinstimmen.

Beispiel

Das folgende Beispiel zeigt ein EntityContainer-Element mit zwei AssociationSet-Elementen:

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