Verwenden mehrerer Versionen von WCF Data Services
Das Open Data Protocol (OData) ermöglicht den Remotezugriff auf eine Datenquelle mittels Standardinternetprotokollen über HTTP. Wenn neue Versionen von OData veröffentlicht werden, verwenden Clientanwendungen möglicherweise nicht die Version von OData , die vom Datendienst unterstützt wird. Eine ältere Clientanwendung greift möglicherweise mithilfe einer neueren Version von OData auf einen Datendienst zu, oder eine Clientanwendung verwendet möglicherweise eine neuere Version der WCF Data Services -Clientbibliothek, die eine neuere Version von OData unterstützt als der OData -Feed, auf den zugegriffen wird.
WCF Data Services nutzt die von OData bereitgestellte Unterstützung zur Behandlung solcher Versionsszenarien. Zudem wird das Generieren und Erstellen von Clientdatendienstklassen mithilfe von Datenmodellmetadaten auch dann unterstützt, wenn der Client eine andere Version von OData verwendet als der Datendienst. Weitere Informationen finden Sie unter OData: Protocol Versioning.
Protokollversionen
Der Datendienst kann so konfiguriert werden, dass die höchste Version des OData -Protokolls definiert wird, die unabhängig von der vom Client angeforderten Version vom Dienst verwendet wird. Hierzu geben Sie einen DataServiceProtocolVersion-Wert für die MaxProtocolVersion-Eigenschaft der vom Datendienst verwendeten DataServiceBehavior-Instanz an. Weitere Informationen finden Sie unter Konfigurieren des Datendiensts (WCF Data Services).
Wenn eine Anwendung mithilfe der WCF Data Services -Clientbibliotheken auf einen Datendienst zugreift, legen die Bibliotheken diese Header je nach OData -Version und den in der Anwendung verwendeten Funktionen automatisch auf die richtigen Werte fest. In der Standardeinstellung verwendet WCF Data Services die niedrigste Protokollversion, die den angeforderten Vorgang unterstützt.
Die folgende Tabelle enthält die Versionen von .NET Framework und Silverlight, die WCF Data Services -Unterstützung für bestimmte Versionen des OData -Protokolls bieten.
| OData -Protokollversion | Unterstützt seit... |
|---|---|
Version 1 |
|
Version 2 |
|
Metadatenversionen
Standardmäßig stellt WCF Data Services Datenmodelle mit Version 1.1 von CSDL dar. Dies ist immer bei Datenmodellen der Fall, die auf einem Reflektionsanbieter oder einem benutzerdefinierten Datendienstanbieter basieren. Wenn das Datenmodell jedoch mit Entity Framework definiert wird, wird die CSDL-Version zurückgegeben, die von Entity Framework verwendet wird. Die CSDL-Version wird durch den Namespace des Schema-Elements bestimmt. Weitere Informationen finden Sie unter in der Spezifikation [MC-CSDL]: Conceptual Schema Definition-Dateiformat.
Das DataServices-Element der zurückgegebenen Metadaten enthält auch ein DataServiceVersion-Attribut, das den gleichen Wert wie der DataServiceVersion-Header in der Antwortnachricht hat. Clientanwendungen wie das Dialogfeld Dienstverweis hinzufügen in Visual Studio generieren mithilfe dieser Informationen Client-Datendienstklassen, die korrekt mit der Version von WCF Data Services funktionieren, die den Datendienst hostet. Weitere Informationen finden Sie unter OData: Protocol Versioning.
Siehe auch
Konzepte
Datendiensteanbieter (WCF Data Services)