Élément EntityContainer (CSDL)

Article
02/27/2011

L'élément EntityContainer dans le langage CSDL (Conceptual Schema Definition Language) est un conteneur logique pour les jeux d'entités, les ensembles d'associations et les importations de fonction. Un conteneur d'entités de modèle conceptuel est mappé à un conteneur d'entités de modèle de stockage via l'élément EntityContainerMapping. Un conteneur d'entités de modèle de stockage décrit la structure de la base de données : les jeux d'entités décrivent les tables, les ensembles d'associations décrivent les contraintes de clé étrangère et les importations de fonction décrivent les procédures stockées dans une base de données. Pour plus d'informations, consultez Élément EntityContainer (SSDL).

Un élément EntityContainer peut avoir zéro ou un élément Documentation. Si un élément Documentation est présent, il doit précéder tous les éléments EntitySet, AssociationSet et FunctionImport.

Un élément EntityContainer peut avoir zéro, un ou plusieurs des éléments enfants suivants (dans l'ordre répertorié) :

Vous pouvez étendre un élément EntityContainer pour inclure le contenu d'un autre élément EntityContainer qui figure dans le même espace de noms. Pour inclure le contenu d'un autre élément EntityContainer dans l'élément EntityContainer de référencement, définissez la valeur de l'attribut Extends en spécifiant le nom de l'élément EntityContainer que vous souhaitez inclure. Tous les éléments enfants de l'élément EntityContainer inclus seront traités comme des éléments enfants de l'élément EntityContainer de référencement.

Attributs applicables

Le tableau suivant décrit les attributs qui peuvent s'appliquer à l'élément Using.

Nom d'attribut	Requis	Valeur
Name	Oui	Nom du conteneur d'entités.
Extends	Non	Le nom d'un autre conteneur d'entités au sein du même espace de noms. (Pour plus d'informations sur les espaces de noms, consultez Élément Schema (CSDL).)

Remarque :
Un nombre quelconque d'attributs d'annotation (attributs XML personnalisés) peut être appliqué à l'élément EntityContainer.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 montre un élément EntityContainer qui définit trois jeux d'entités et deux ensembles d'associations.

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

Voir aussi

Concepts

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

Autres ressources

Spécifications CSDL, SSDL et MSL
ADO.NET Entity Data Model Tools
entity container (Entity Data Model)

Partager via