Share via


CSDL-Spezifikation

Die konzeptionelle Schemadefinitionssprache (CSDL) ist eine XML-basierte Sprache, die die Entitäten, Beziehungen und Funktionen beschreibt, die ein konzeptionelles Modell einer datengesteuerten Anwendung bilden. Dieses konzeptionelle Modell kann von Entity Framework oder ADO.NET Data Services verwendet werden. Die Metadaten, die in CSDL beschrieben werden, werden von Entity Framework verwendet, um Entitäten und Beziehungen zuzuordnen, die in einem konzeptionellen Modell für eine Datenquelle definiert werden. Weitere Informationen finden Sie unter SSDL-Spezifikation und MSL-Spezifikation.

CSDL ist die Implementierung des Entity Data Model in Entity Framework .

In einer Entity Framework -Anwendung werden Metadaten des konzeptionellen Modells aus einer CSDL-Datei (geschrieben in CSDL) in eine Instanz der System.Data.Metadata.Edm.EdmItemCollection geladen und können mithilfe von Methoden der System.Data.Metadata.Edm.MetadataWorkspace-Klasse abgerufen werden. Entity Framework verwendet Metadaten des konzeptionellen Modells, um Abfragen für das konzeptionelle Modell in datenquellenspezifische Befehle zu übersetzen.

Bb399292.note(de-de,VS.100).gifHinweis:
Der Entity Data Model-Designer (Entity Designer) speichert zur Entwurfszeit Informationen zum konzeptionellen Modell in einer EDMX-Datei.Zur Erstellungszeit verwendet der Entity Designer Informationen in einer EDMX-Datei, um die CSDL-Datei zu erstellen, die zur Laufzeit von Entity Framework benötigt wird.Weitere Informationen finden Sie unter Übersicht über die EDMX-Datei.

Die Metadaten des konzeptionellen Modells können verwendet werden, um den Code auf Objektebene für eine Entity Framework -Anwendung zu generieren. Weitere Informationen finden Sie unter Übersicht über generierten Code (Entity Data Model-Designer) und Gewusst wie: Generieren von Code auf Objektebene mithilfe von EdmGen.exe.

Das XML-Schema für die CSDL-Datei befindet sich im Ordner "XML\Schemas" des Installationsverzeichnisses von Visual Studio (z. B., C:\Programme\Microsoft-Visual Studio 10.0 \Xml\Schemas). Das Schema für Anwendungen, die auf .NET Framework, Version 4, abzielen, wird in der Datei "System.Data.Resources.CSDLSchema_2.xsd" definiert. Das Schema für Anwendungen, die auf .NET Framework, Version 3.5 SP1, abzielen, wird in der Datei "System.Data.Resources.CSDLSchema_1.xsd" definiert.

Bb399292.note(de-de,VS.100).gifHinweis:
Die verschiedenen Versionen von CSDL werden von XML-Namespaces unterschieden.Der "https://schemas.microsoft.com/ado/2008/09/edm"-Namespace ist für konzeptionelle Modelle in Anwendungen vorgesehen, die auf .NET Framework4 abzielen.Der "https://schemas.microsoft.com/ado/2006/04/edm"-Namespace ist für konzeptionelle Modelle in Anwendungen vorgesehen, die auf .NET Framework3.5 SP1 abzielen.Informationen zu anderen CSDL-Versionen und ihren Verwendungen finden Sie unter ADO.NET Data Services.

Inhalt dieses Abschnitts

Association-Element (CSDL)

AssociationSet-Element (CSDL)

CollectionType-Element (CSDL)

ComplexType-Element (CSDL)

DefiningExpression-Element (CSDL)

Abhängiges Element (CSDL)

Documentation-Element (CSDL)

End-Element (CSDL)

EntityContainer-Element (CSDL)

EntitySet-Element (CSDL)

EntityType-Element (CSDL)

Function-Element (CSDL)

FunctionImport-Element (CSDL)

Key-Element (CSDL)

NavigationProperty-Element (CSDL)

OnDelete-Element (CSDL)

Parameter-Element (CSDL)

Prinzipalelement (CSDL)

Property-Element (CSDL)

PropertyRef-Element (CSDL)

ReferenceType-Element (CSDL)

ReferentialConstraint-Element (CSDL)

ReturnType-Element (CSDL)

RowType-Element (CSDL)

Schema-Element (CSDL)

TypeRef-Element (CSDL)

Using-Element (CSDL)

Anmerkungsattribute (CSDL)

Anmerkungelemente (CSDL)

Konzeptionelle Modelltypen

Facets (CSDL)

Siehe auch

Konzepte

Übersicht über das Entity Framework

Weitere Ressourcen

CSDL-, SSDL- und MSL-Spezifikationen
ADO.NET Entity Data Model Tools