Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il framework di ADO.NET Data Services implementa uno schema di indirizzamento che consente di individuare i dati tramite URI. I modelli entità-relazione illustrati in Entity Data Model vengono utilizzati per organizzare i dati come entità e associazioni con le entità raggruppate logicamente in set di entità. Questi modelli vengono riflessi nello schema di indirizzamento URI.
Per illustrare in maniera esemplificativa il sistema, negli esempi seguenti viene utilizzato un servizio di rilevamento clienti. Tutte le entità Customer vengono indirizzate dall'URI seguente:
http://myserver/data.svc/Customers
Il segmento /Customers dell'URI punta al set di entità Customer specificato nei metadati. I metadati del framework di ADO.NET Data Services sono equivalenti allo schema concettuale del modello EDM. Il set di entità, Customers, include logicamente tutte le istanze del tipo di entità Customer.
L'URI illustrato nella sintassi seguente recupera un'entità Customer singola con proprietà della chiave di valore 'ALFKI', come definito nei metadati.
http://myserver/data.svc/Customers('ALFKI')
Entità e associazioni
I metadati descrivono la struttura dei tipi di entità e le associazioni tra le entità. Nel framework di ADO.NET Data Services queste informazioni vengono utilizzate per fornire un meccanismo di attraversamento delle associazioni. Se, ad esempio, a ognuna delle entità Customer presenti nel servizio dati è associato un set di entità Orders, l'URI seguente rappresenta il set degli ordini di vendita associato all'entità Customer la cui chiave primaria dispone di valore 'ALFKI'.
http://myserver/data.svc/Customers('ALFKI')/Orders
Le proprietà di un'entità Customer possono essere indirizzate singolarmente. L'URI seguente rappresenta, ad esempio, la proprietà ContactName dell'entità Customer con chiave 'ALFKI':
http://myserver/data.svc/Customers('ALFKI')/ContactName
Oltre alle query basate su chiavi, è possibile includere predicati semplici nello schema di indirizzamento. Ciò consente di selezionare i set di dati in base alle proprietà delle entità, ad esempio il set di entità Orders attualmente attivo per l'entità Customer con chiave 'ALFKI'. Questi dati vengono recuperati mediante l'URI seguente:
http://myserver/data.svc/Customers('ALFKI')/Orders?$filter=Active eq true
È inoltre possibile utilizzare l'operatore $filter dell'esempio precedente insieme a funzioni di matematica, stringa o data. L'URI seguente rappresenta il set di ordini attivi eseguito nel 2007 per l'entità Customer con chiave 'ALFKI':
http://myserver/data.svc/Customers('ALFKI')/Orders?$filter=
Active eq true and (year(OrderDate) eq 2007)
Se al set di entità Orders sono correlate altre entità, l'URI può continuare a eseguire il drill-down nel grafico delle associazioni, attraversare le associazioni e filtrare ogni set risultante.
Informazioni sul controllo della presentazione
Gli URI di ADO.NET Data Services possono includere informazioni anche nella stringa di query che ordina i dati. I requisiti comuni per le applicazioni Internet includono il paging dei dati e l'ordinamento in base alle proprietà. Nell'URI seguente vengono elencate le entità Orders ordinate per data:
http://myserver/data.svc/Customers('ALFKI')/Orders?$filter=
Active eq true&$orderby=OrderDate
I risultati di paging vengono creati combinando i parametri $skip e $top. In un elenco di clienti, i numeri da 31 a 41 vengono visualizzati dall'URI seguente:
http://myserver/data.svc/Customers?$skip=30&$top=10
GET, PUT, POST e DELETE
La sintassi degli esempi precedenti viene utilizzata in una richiesta GET HTTP per recuperare entità e insiemi di entità. Per aggiornare le entità o le relazioni, in ADO.NET Data Services viene utilizzata la sintassi PUT HTTP. Analogamente, per creare nuove entità viene utilizzata la sintassi POST HTTP e per eliminare entità dall'archivio la sintassi DELETE HTTP. Per ulteriori informazioni, vedere Applicazioni client di ADO.NET Data Services.
Vedere anche
Concetti
Servizi e semantica REST (framework di ADO.NET Data Services)
Requisiti HTTP comuni (framework di ADO.NET Data Services)