EntityContainer-Element (CSDL)

Artikel
02/27/2011

Das EntityContainer-Element in konzeptioneller Schemadefinitionssprache (CSDL) ist ein logischer Container für Entitätssätze, Zuordnungssätze und Funktionsimporte. Einem Speichermodell-Entitätscontainer wird durch das EntityContainerMapping-Element ein konzeptioneller Modellentitätscontainer zugeordnet. Ein Speichermodell-Entitätscontainer beschreibt die Struktur der Datenbank: Entitätssätze beschreiben Tabellen, Zuordnungssätze beschreiben Fremdschlüsseleinschränkungen, und Funktionsimporte beschreiben gespeicherte Prozeduren in einer Datenbank. Weitere Informationen finden Sie unter EntityContainer-Element (SSDL).

Ein EntityContainer-Element kann über kein (null) oder ein Dokumentationselement verfügen. Ist ein Documentation-Element vorhanden, muss es allen EntitySet-, AssociationSet- und FunctionImport-Elementen vorangestellt werden.

Ein EntityContainer-Element kann über kein (null) oder mehrere der folgenden untergeordneten Elemente verfügen (der vorliegenden Reihenfolge entsprechend):

Sie können ein EntityContainer-Element erweitern, um den Inhalt eines anderen EntityContainer einzuschließen, der sich im gleichen Namespace befindet. Zum Einschließen des Inhalts eines anderen EntityContainer im verweisenden EntityContainer-Element legen Sie den Wert des Extends-Attributs auf den Namen des EntityContainer-Elements fest, das Sie einschließen möchten. Alle untergeordneten Elemente des eingeschlossenen EntityContainer-Elements werden als untergeordnete Elemente des verweisenden EntityContainer-Elements behandelt.

Anwendbare Attribute

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

Attributname	Ist erforderlich	Wert
Name	Ja	Der Name des Entitätscontainers.
Extends	Nein	Der Name eines anderen Entitätscontainers innerhalb des gleichen Namespaces. Weitere Informationen zu Namespaces finden Sie unter Schema-Element (CSDL).

Hinweis:
Eine beliebige Anzahl von Anmerkungsattributen (benutzerdefinierte XML-Attribute) kann für das EntityContainer-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

Im folgenden Beispiel wird ein EntityContainer-Element dargestellt, das drei Entitätenmengen und zwei Zuordnungssätze definiert.

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

Siehe auch

Konzepte

Übersicht über das Entity Framework
CSDL-Spezifikation
Schema-Element (CSDL)

Weitere Ressourcen

CSDL-, SSDL- und MSL-Spezifikationen
ADO.NET Entity Data Model Tools
entity container (Entity Data Model)

Share via