Élément Principal (CSDL)

Article
02/27/2011

L'élément Principal dans le langage CSDL (Conceptual Schema Definition Language) est un élément enfant de l'élément ReferentialConstraint qui définit la terminaison principale d'une contrainte référentielle. Un élément ReferentialConstraint définit des fonctionnalités qui sont semblables à une contrainte d'intégrité référentielle dans une base de données relationnelle. De la même manière qu'une ou plusieurs colonnes d'une table de base de données peuvent référencer la clé primaire d'une autre table, une ou plusieurs propriétés d'un type d'entité peuvent référencer la clé d'entité d'un autre type d'entité. Le type d'entité référencé est appelé terminaison principale de la contrainte. Le type d'entité qui référence la terminaison principale est appelé terminaison dépendante de la contrainte. Les éléments PropertyRef sont utilisés pour spécifier les clés référencées par la terminaison dépendante.

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

PropertyRef (un ou plusieurs éléments) ;
éléments d'annotation (zéro, un ou plusieurs éléments).

Attributs applicables

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

Nom d'attribut	Requis	Valeur
Role	Oui	Nom du type d'entité au niveau de la terminaison principale de l'association.

Remarque :
Un nombre quelconque d'attributs d'annotation (attributs XML personnalisés) peut être appliqué à l'élément Principal.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 ReferentialConstraint utilisé dans le cadre de la définition de l'association PublishedBy. La propriété Id du type d'entité Publisher compose la terminaison principale de la contrainte référentielle.

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

Voir aussi

Concepts

Vue d'ensemble d'Entity Framework
Spécification CSDL
Élément Schema (CSDL)
Élément Association (CSDL)
Élément Dependent (CSDL)

Autres ressources

Spécifications CSDL, SSDL et MSL
ADO.NET Entity Data Model Tools

Partager via