Opzioni query del sistema ADO.NET Data Services

Le opzioni query del sistema URI rappresentano le direttive utilizzate per controllare la risposta a una richiesta in ADO.NET Data Services. Nelle tabelle seguenti vengono riepilogate le opzioni supportate da ADO.NET Data Services.

Riepilogo delle opzioni query di sistema supportate

Nelle tabelle riportate di seguito vengono elencate e illustrate le opzioni query utilizzate dagli URI di ADO.NET Data Services. Queste opzioni possono essere aggiunte alle query per limitare oppure ordinare i risultati.

Opzione Descrizione

$expand

Consente di richiedere che i set a cui viene fatto riferimento nel set di destinazione vengano restituiti inline anziché come contenuto posticipato.

$filter

Restituisce dal set di destinazione solo gli elementi che soddisfanno il predicato specificato.

$orderby

Ordina il set di entità di destinazione in sequenza crescente o decrescente.

$skip

Ricerca n elementi nella destinazione, quindi restituisce n+1 elementi alla fine del set.

$top

Restituisce n elementi superiori dal set di destinazione.

Se un'opzione query viene inclusa nell'URI a una risorsa che non supporta l'operazione, viene restituito il codice di risposta 400 Richiesta non valida.

Ordine di applicazione delle opzioni query

Nell'elenco riportato di seguito viene specificato l'ordine di applicazione delle query in un servizio ADO.NET Data Service. Se una delle opzioni risulta mancante, il passaggio corrispondente viene ignorato.

$filter. Limita il set di elementi restituiti.

$orderby. Imposta l'ordine degli elementi restituiti.

$skip. Ignora un numero di elementi.

$top. Limita il numero di elementi restituiti.

$expand. Restituisce il contenuto correlato agli elementi di base restituiti.

L'URI http://www.example.com/service.svc/Orders?$orderby=ID&$top=10&$skip=10 indica che saranno restituiti gli ordini dal numero 11 al numero 21 dall'elenco di ordini ordinati in base ai valori della proprietà ID.

Opzioni query di sistema supportate per URI

Nelle tabelle seguenti vengono enumerate le opzioni query supportate o non supportate da ogni tipo di sintassi URI. Ogni esempio di sintassi è seguito da una tabella in cui sono elencate le opzioni supportate per la sintassi.

URI: serviceName/<EntitySet>
Opzione Supportata Note

$expand

Sì

Restituisce un set di entità.

$filter

Sì

Restituisce un set di entità.

$orderby

Sì

Restituisce un set di entità.

$skip

Sì

Restituisce un set di entità.

$top

Sì

Restituisce un set di entità.

 
URI: serviceName/<ResourceSet>(KeyPredicate)
Opzione Supportata Note

$expand

Sì

Restituisce le risorse identificate dalle condizioni specificate, solitamente i dati in relazione al set di risorse di base.

$filter

Sì

Restituisce le risorse se la condizione di filtro è vera; in caso contrario, verrà restituita una risposta 404 Risorsa non trovata.

$orderby

No

$skip

No

$top

No

 

URI: serviceName/<ResourceSet>(KeyPredicate)/<ResourceComplexType>
Opzione Supportata Note

$expand

Sì

I tipi complessi vengono sempre espansi anche se $expand non è presente nell'URI.

$filter

Sì

Restituisce un'istanza di tipo complesso se la condizione di filtro è vera; in caso contrario, verrà restituita una risposta 404 Risorsa non trovata.

$orderby

No

$skip

No

$top

No

 

URI: serviceName/<ResourceSet>(KeyPredicate)/<ResourceComplexType>/<ResourceProperty>
Opzione Supportata Note

$expand

Sì

I tipi complessi vengono sempre espansi anche se $expand non è presente nell'URI. La proprietà della risorsa non dispone di proprietà che possono essere espanse se non è un tipo complesso.

$filter

No

$orderby

No

$skip

No

$top

No

 

URI: serviceName/<ResourceSet>(KeyPredicate)/<ResourceProperty>
Opzione Supportata Note

$expand

Sì

I tipi complessi vengono sempre espansi anche se $expand non è presente nell'URI. La proprietà della risorsa non dispone di proprietà che possono essere espanse se non è un tipo complesso.

$filter

No

$orderby

No

$skip

No

$top

No

 

URI: serviceName/<Resource Set>(KeyPredicate)/<ResourceNavigationProperty>

Se la proprietà di navigazione nell'esempio precedente rappresenta una relazione uno-a-uno o molti-a-uno, le opzioni query vengono descritte dalla tabella seguente:

Opzione Supportata Note

$expand

Sì

Restituisce un'istanza del tipo di entità.

$filter

Sì

Restituisce un'istanza del tipo di entità.

$orderby

No

$skip

No

$top

No

Se la proprietà di navigazione rappresenta una relazione uno-a-molti o molti-a-molti, le opzioni query vengono descritte dalla tabella seguente:

Opzione Supportata Note

$expand

Sì

Restituisce un set di entità.

$filter

Sì

Restituisce un set di entità.

$orderby

Sì

Restituisce un set di entità.

$skip

Sì

Restituisce un set di entità.

$top

Sì

Restituisce un set di entità.

Vedere anche

Concetti

Opzioni query di ADO.NET Data Services
Parametri delle operazioni di servizio (framework di ADO.NET Data Services)

  • Last updated on