EntityType-Element (CSDL)

Artikel
12/10/2012

Das EntityType-Element stellt in einem konzeptionellen Modell die Struktur eines Konzepts auf der obersten Ebene dar, beispielsweise einen Kunden oder eine Bestellung.Ein Entitätstyp ist eine Vorlage für Instanzen von Entitätstypen in einer Anwendung.Jede Vorlage enthält die folgenden Informationen:

Eine eindeutige Bezeichnung.(Erforderlich)
Ein Entitätsschlüssel, der von einem oder mehreren Eigenschaften definiert wird.(Erforderlich)
Eigenschaften für enthaltene Daten.(Optional)
Navigationseigenschaften, die die Navigation von einem Ende einer Zuordnung zum anderen Ende ermöglichen.(Optional)

In einer Anwendung stellt eine Instanz eines Entitätstyps ein spezielles Objekt dar, wie etwa einen bestimmten Kunden oder eine Bestellung.Jede Instanz eines Entitätstyps muss über einen eindeutigen Entitätsschlüssel innerhalb eines Entitätssatzes verfügen.

Zwei Instanzen eines Entitätstyps werden nur dann als gleich betrachtet, wenn sie vom selben Typ sind und die Werte ihrer Entitätsschlüssel übereinstimmen.

Ein EntityType-Element kann die folgenden untergeordneten Elemente aufweisen (der vorliegenden Reihenfolge entsprechend):

Dokumentation (kein (null) oder ein Element)
Key (kein (null) oder ein Element)
Property (0 (null) oder mehr Elemente)
NavigationProperty (kein Element (null) oder mehrere Elemente)
Anmerkungselemente (kein Element (null) oder mehrere Elemente)

Anwendbare Attribute

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

Attributname	Ist erforderlich	Value
Name	Ja	Der Name des Entitätstyps.
BaseType	Nein	Der Name eines anderen Entitätstyps, der der Basistyp des zu definierenden Entitätstyps ist.
Abstract	Nein	True oder False, abhängig von, ob der Entitätstyp ein abstrakter Typ ist.
OpenType	Nein	True oder False abhängig von, ob der Entitätstyp ein offener Entitätstyp ist. Hinweis Das OpenType-Attribut ist nur auf Entitätstypen anwendbar, die in konzeptionellen Modellen definiert werden, die mit WCF Data Services verwendet werden.

Hinweis

Eine beliebige Anzahl von Anmerkungsattributen (benutzerdefinierte XML-Attribute) kann für das EntityType-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 EntityType-Element mit drei Property-Elementen und zwei NavigationProperty-Elementen:

<EntityType Name="Book">
  <Key>
    <PropertyRef Name="ISBN" />
  </Key>
  <Property Type="String" Name="ISBN" Nullable="false" />
  <Property Type="String" Name="Title" Nullable="false" />
  <Property Type="Decimal" Name="Revision" Nullable="false" Precision="29" Scale="29" />
  <NavigationProperty Name="Publisher" Relationship="BooksModel.PublishedBy"
                      FromRole="Book" ToRole="Publisher" />
  <NavigationProperty Name="Authors" Relationship="BooksModel.WrittenBy"
                      FromRole="Book" ToRole="Author" />
</EntityType>