Condividi tramite


Utilizzo di più versioni di WCF Data Services

OData (Open Data Protocol) consente di accedere a un'origine dati in modalità remota tramite i protocolli Internet standard su HTTP. Al rilascio di nuove versioni di OData è possibile che la versione di OData utilizzata nelle applicazioni client non coincida con quella supportata dal servizio dati. Un'applicazione client precedente può accedere a un servizio dati utilizzando una versione più recente di OData o è possibile che un'applicazione client utilizzi una versione più recente della libreria client WCF Data Services che supporta una versione più recente di OData rispetto a quella del feed OData cui si accede.

WCF Data Services si avvale del supporto fornito da OData per gestire tali scenari di controllo delle versioni. È inoltre disponibile il supporto per la generazione e l'utilizzo di metadati del modello di dati per creare le classi del servizio dati client quando la versione di OData utilizzata dal client differisce da quella del servizio dati. Per ulteriori informazioni, vedere OData: Controllo delle versioni dei protocolli.

Versioni di protocollo

È possibile configurare il servizio dati per definire la versione massima del protocollo OData che verrà utilizzata dal servizio, indipendentemente dalla versione richiesta dal client. A tale scopo è possibile specificare un valore DataServiceProtocolVersion per la proprietà MaxProtocolVersion dell'oggetto DataServiceBehavior utilizzato dal servizio dati. Per ulteriori informazioni, vedere Configurazione del servizio dati (WCF Data Services)

Quando un'applicazione utilizza le librerie client WCF Data Services per accedere a un servizio dati, le intestazioni delle librerie vengono impostate automaticamente sui valori corretti, a seconda della versione di OData e delle caratteristiche utilizzate nell'applicazione. Per impostazione predefinita, WCF Data Services utilizza la versione minima del protocollo che supporta l'operazione richiesta.

Nella tabella seguente sono contenuti i dettagli delle versioni di .NET Framework e Silverlight che includono il supporto WCF Data Services per versioni specifiche del protocollo OData .

Versione del protocollo OData Supporto introdotto in…

Versione 1

  • .NET Framework versione 3.5 Service Pack 1 (SP1)

  • Silverlight versione 3

Versione 2

  • .NET Framework versione 4

  • Aggiornamento a .NET Framework versione 3.5 SP1. Questo aggiornamento può essere scaricato e installato dall'Area download Microsoft.

  • Silverlight versione 4

Versioni di metadati

Per impostazione predefinita, WCF Data Services utilizza la versione 1.1 di CSDL per rappresentare un modello di dati. Questo comportamento viene applicato sempre nel caso di modelli di dati basati su un provider di reflection o un provider del servizio dati personalizzato. Tuttavia, quando il modello di dati è definito tramite Entity Framework , viene restituita la stessa versione di CSDL utilizzata da Entity Framework . La versione di CSDL è determinata dallo spazio dei nomi dell'elemento Schema. Per ulteriori informazioni, vedere la specifica [MC-CSDL]: formato di file di definizione schema concettuale.

L'elemento DataServices dei metadati restituiti contiene inoltre un attributo DataServiceVersion che corrisponde al valore dell'intestazione DataServiceVersion nel messaggio di risposta. Le applicazioni client, ad esempio la finestra di dialogo Aggiungi riferimento al servizio in Visual Studio, utilizzano queste informazioni per generare classi del servizio dati client che funzionano correttamente con la versione di WCF Data Services che funge da host del servizio dati. Per ulteriori informazioni, vedere OData: Controllo delle versioni dei protocolli.

Vedere anche

Concetti

Provider di servizi dati (WCF Data Services)

Altre risorse

Definizione di WCF Data Services