Élément AssociationSet (CSDL)

Article
12/10/2012

L'élément AssociationSet dans le langage CSDL (Conceptual Schema Definition Language) est un conteneur logique pour les instances d'association du même type.Un ensemble d'associations fournit une définition pour le regroupement d'instances d'association afin qu'elles puissent être mappées à une source de données.Pour plus d'informations sur le mappage, consultez Élément AssociationSetMapping (MSL).

L'élément AssociationSet peut avoir les éléments enfants suivants (dans l'ordre répertorié) :

Documentation (zéro ou un élément autorisé) ;
End (exactement deux éléments requis) ;
éléments d'annotation (zéro, un ou plusieurs éléments autorisés).

L'attribut Association spécifie le type d'association qu'un ensemble d'associations contient.Les jeux d'entités qui composent les terminaisons d'un ensemble d'associations sont spécifiés avec exactement deux éléments End enfants.

Attributs applicables

Le tableau ci-dessous décrit les attributs qui peuvent s'appliquer à l'élément AssociationSet.

Nom d'attribut	Requis	Valeur
Name	Oui	Nom du jeu d'entités.La valeur de l'attribut Name ne peut pas être la même que la valeur de l'attribut Association.
Association	Oui	Nom qualifié complet de l'association dont l'ensemble d'associations contient des instances.L'association doit être dans le même espace de noms que l'ensemble d'associations.

Notes

Un nombre quelconque d'attributs d'annotation (attributs XML personnalisés) peut être appliqué à l'élément AssociationSet.Toutefois, les attributs personnalisés ne peuvent pas appartenir à un espace de noms XML réservé pour le langage CSDL.Les noms qualifiés complets de deux attributs personnalisés quelconques ne peuvent pas être identiques.

Exemple

L'exemple suivant illustre un élément EntityContainer avec deux éléments AssociationSet :

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