Generieren der Clientdatendienstklassen (WCF Data Services)
Ein Datendienst, der Open Data Protocol (OData) implementiert, kann ein Dienstmetadatendokument zurückgeben, in dem das vom OData-Feed verfügbar gemachte Datenmodell beschrieben wird. Weitere Informationen finden Sie in OData: Dienstmetadatendokument. Sie können das Dialogfeld Dienstverweis hinzufügen in Visual Studio verwenden, um einem OData-basierten Dienst einen Verweis hinzuzufügen. Wenn Sie dieses Tool verwenden, um den von einem OData-Feed in einem Clientprojekt zurückgegebenen Metadaten einen Verweis hinzuzufügen, führt es die folgenden Aktionen aus:
Fordert das Dienstmetadatendokument vom Datendienst an und interpretiert die zurückgegebenen Metadaten.
Hinweis
Die zurückgegebenen Metadaten werden im Clientprojekt als EDMX-Datei gespeichert.Diese EDMX-Datei kann nicht mit dem Entity Data Model-Designer geöffnet werden, da sie nicht das gleiche Format wie eine vom Entity Framework verwendete EDMX-Datei aufweist.Sie können diese Metadatendatei mit dem XML-Editor oder einem beliebigen Texteditor anzeigen.Weitere Informationen finden Sie in der Spezifikation [MC-EDMX]: Entity Data Model for Data Services Packaging Format.
Generiert eine Darstellung des Diensts als Entitätscontainerklasse, die vom DataServiceContext erbt. Diese generierte Entitätscontainerklasse entspricht dem Entitätscontainer, den die Entity Data Model-Tools generieren. Weitere Informationen finden Sie unter Object Services Overview (Entity Framework).
Generiert Datenklassen für die in den Dienstmetadaten erkannten Datenmodelltypen.
Fügt dem Projekt einen Verweis auf die Microsoft.Data.Services.Client.dll-Assembly hinzu.
Hinweis
Wenn WCF Data Services, Version 5.0, installiert wird, fügt das Tool Dienstverweis hinzufügen automatisch einen Verweis auf die neue Version der Clientbibliothek hinzu, statt einen Verweis auf die System.Data.Services.Client.dll-Version hinzuzufügen, die in .NET Framework enthalten ist.Wenn Sie aus irgendwelchen Gründen die vorherige Version des WCF Data Services-Clients verwenden müssen, sollten Sie manuell einen Verweis auf die .NET Framework-Version dieser Bibliothek hinzufügen.Weitere Informationen finden Sie unter Gewusst wie: Manuelles Generieren von Clientdatendienstklassen (WCF Data Services).
Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen eines Datendienstverweises (WCF Data Services).
Die Clientdatendienstklassen können auch an der Eingabeaufforderung mit dem Tool DataSvcUtil.exe generiert werden. Weitere Informationen finden Sie unter Gewusst wie: Manuelles Generieren von Clientdatendienstklassen (WCF Data Services).
Zuordnung von Clientdatentypen
Wenn Sie mithilfe des Dialogfelds Dienstverweis hinzufügen in Visual Studio oder des DataSvcUtil.exe-Tools Clientdatenklassen generieren, die auf einem OData-Feed basieren, werden die .NET Framework-Datentypen wie folgt den primitiven Typen aus dem Datenmodell zugeordnet:
Datenmodelltyp |
.NET Framework-Datentyp |
|---|---|
Edm.Binary |
Byte[] |
Edm.Boolean |
|
Edm.Byte |
|
Edm.DateTime |
|
Edm.Decimal |
|
Edm.Double |
|
Edm.Guid |
|
Edm.Int16 |
|
Edm.Int32 |
|
Edm.Int64 |
|
Edm.SByte |
|
Edm.Single |
|
Edm.String |
Weitere Informationen finden Sie unter OData: Primitive Datentypen.
Siehe auch
Konzepte
Schnellstart (WCF Data Services)