Opzioni query di ADO.NET Data Services

Come descritto in Formato URI di indirizzamento delle risorse (framework di ADO.NET Data Services), nel segmento di opzione query dell'URI vengono specificati due tipi di informazioni:

  1. Opzioni query del sistema ADO.NET Data Services.

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

Opzioni query e parametri dell'operazione del servizio devono essere entrambi conformi alle regole seguenti:

  • In una sola stringa di query URI è possibile specificare il numero desiderato delle opzioni query supportate.

  • Ogni opzione query può essere presente in una stringa di query indipendente dalla presenza di qualsiasi altra opzione.

  • L'ordine delle opzioni query all'interno di un URI non è significativo.

  • I nomi delle opzioni query seguono la distinzione tra maiuscole e minuscole.

  • I valori delle opzioni query seguono la distinzione tra maiuscole e minuscole.

  • Una determinata opzione query del sistema può essere presente una sola volta nella stringa di query di un URI di richiesta.

Sintassi

Nella sezione seguente viene definito un set di regole per costruire un URI di ADO.NET Data Services utilizzando gli elementi di sintassi della specifica BNF (Backus-Naur Form) definita nel documento RFC 4234. Un URI di ADO.NET Data Services è costituito da tre sezioni: radice del servizio, percorso della risorsa e opzioni query, che, se composte, possono formare un URI per indirizzare qualsiasi risorsa.

ADO.NET_DataService_URI = "http://" serviceRoot [ resourcePath ["?" queryOptions ] ]

serviceRoot = host [ ":" port ] [*( "/" segment-nz )]

resourcePath = "/" resourceSet | serviceOperation [ navPath ] 

navPath = ("("keyPredicate")" [ navPath_np / propertyPath / propertyPath_ct ] )

navPath_np = "/" resourceNavigationProperty [ navPath ]

propertyPath = "/" resourceProperty [ "/$value" ] 

propertyPath_ct = 1*("/" resourceComplexType) [ propertyPath ]

keyPredicate = 1*DIGIT / ("’" 1*unreserved "’") / 1*(HEXDIG HEXDIG) ["," keyPredicate]
 //NOTE: strings, GUIDs, and dates are enclosed in quotation marks.

queryOptions = sysQueryOperation / serviceOpParamName *(“&” sysQueryOperation / serviceOpParam)

Le definizioni precedenti utilizzano la terminologia del documento RFC 3986:

  • DIGIT è uguale a quanto definito nel documento RFC 3986 (0-9)

  • host è uguale a quanto definito nel documento RFC 3986

  • port è uguale a quanto definito nel documento RFC 3986

  • segment-nz è uguale a quanto definito nel documento RFC 3986 (sequenza di caratteri non vuota all'esterno del set di caratteri riservati per gli URI)

  • pchar è uguale a quanto definito nel documento RFC 3986 (sequenza di caratteri non vuota all'esterno del set di caratteri riservati per gli URI)

L'ambito e il significato semantico di ognuna delle regole sono:

  • Service operation: nome di un'operazione del servizio. Vedere Parametri delle operazioni di servizio (framework di ADO.NET Data Services).

  • resourceSet: nome di un set di risorse. I caratteri consentiti corrispondono al set di caratteri consentiti per i nomi EntitySet nella specifica EDM (Entity Data Model).

  • Resource type: nome di un tipo di risorsa all'interno del set di risorse a cui viene fatto riferimento nel segmento di percorso precedente. I caratteri consentiti corrispondono al set di caratteri consentiti per i nomi EntityType nella specifica EDM (Entity Data Model).

  • Resource property: nome di una proprietà di risorsa sul tipo semplice o complesso di risorsa nel segmento di percorso. I caratteri consentiti corrispondono al set di caratteri consentiti per i nomi di proprietà EntityType nella specifica EDM.

  • Resource navigation property: nome di una proprietà di navigazione o di un collegamento di navigazione tra risorse sul tipo di risorsa del segmento di percorso precedente. Se il segmento precedente è un set di risorse, la proprietà deve essere impostata sul tipo all'interno del set di risorse specificato. Per ulteriori informazioni su proprietà e collegamenti di navigazione, vedere Regole e semantica del percorso delle risorse (framework di ADO.NET Data Services). I caratteri consentiti corrispondono al set di caratteri consentiti per i nomi delle proprietà di navigazione nella specifica EDM.

  • System query operation= "$" query "=" query Questo tipo di sintassi inizia con $ dopo ? nell'URI. Per ulteriori informazioni, vedere Opzioni query del sistema ADO.NET Data Services.

  • Service Operation Parameter= query "=" query Queste query sono parametri per operazioni di servizio. È possibile inserire query per un'operazione di servizio con i risultati delle query restituiti come parametri all'interno della funzione. Per ulteriori informazioni, vedere Parametri delle operazioni di servizio (framework di ADO.NET Data Services).

Nella sintassi seguente vengono riportate le parti di differenziazione di un URI di ADO.NET Data Service.

http://www.example.com:88/path/service.root.svc/Customers(‘ALFKI’)/Orders?$skip=2&$take=2

Fanno parte dell'URI:

Radice del servizio:www.example.com:88/path/service.root.svc

Host: www.example.com

Porta: 88

Percorso della risorsa: /Customers(‘ALFKI’)/Orders

Set di risorse: Customers

Percorso di navigazione: (‘ALFKI’)/Orders

Predicato chiave: ‘ALFKI’

Proprietà di navigazione del percorso di navigazione: Orders

Opzioni query: $skip=2&$top=2

Vedere anche

Concetti

Regole e semantica del percorso delle risorse (framework di ADO.NET Data Services)
Opzioni query del sistema ADO.NET Data Services
Parametri delle operazioni di servizio (framework di ADO.NET Data Services)

  • Last updated on