Uso della sintassi di query avanzata a livello di codice

Advanced Query Syntax (AQS) è la sintassi di query predefinita usata da Windows Search per eseguire query sull'indice e per perfezionare e restringere i parametri di ricerca. AQS viene usato dagli sviluppatori per creare query a livello di codice (e dagli utenti per restringere i parametri di ricerca). Canonical AQS è stato introdotto in Windows 7 e deve essere usato in Windows 7 e versioni successive per generare query AQS a livello di codice.

Questo argomento è organizzato come segue:

• Informazioni sulla sintassi delle query avanzate
  • Esempi
  • Proprietà
• Uso delle parole chiave nei linguaggi locali
• Sintassi di query avanzate canoniche in Windows 7
  • Esempi
  • Operatori di query
  • Valori di query
• Restrizioni di ambito
• Risorse aggiuntive
• Argomenti correlati

Informazioni sulla sintassi delle query avanzate

Una query è costituita da query di base connesse con AND, OR e NOT, come illustrato nella sintassi di esempio seguente:

<query> ::=
     <basic query>
| ( <query> )
| <query> AND <query>  
| <query> <query>    // Same as <query> AND <query>
| <query> OR <query> 
| NOT <query>

Se una query ha due o più usi di AND o OR, verranno associati da sinistra a destra, indipendentemente dal fatto che si tratti di AND o OR. Ovvero, la query "apple AND pear OR plum" verrà interpretata come se fosse stata scritta come "(apple AND pear) OR plum" e la query , "apple OR pear AND plum", verrà interpretata come "(apple OR pera) AND plum". Pertanto, se un documento contiene la parola plum ma né mela, né pera, la prima query lo restituirà, ma la seconda query non lo restituirà. È quindi consigliabile usare parentesi esplicite per qualsiasi query che combina AND e OR per evitare errori o interpretazione errata.

Una query di base cerca gli elementi che soddisfano una restrizione su una proprietà. L'unica parte necessaria di una query di base è la restrizione o il valore di ricerca. Se non specifichi una proprietà, Windows Search cerca tutte le proprietà. <restr> rappresenta la restrizione di ricerca.

I moduli seguenti per una query di base sono validi:

<basic query> ::=
     <prop>:<basic restr>
| <restr>

Una proprietà è designata da una parola chiave, ad esempio autore o dimensione, o da un nome di proprietà canonico, ad esempio System.DateModified. I moduli validi per una proprietà sono i seguenti:

<prop> ::= 
     <canonical property name>
| <property label in UI language>

Un operatore indica un'operazione come < o =. Per un elenco di operatori validi, vedere la sezione Operatori di query più avanti in questo argomento.

Una restrizione di base è una restrizione semplice per una proprietà che può essere scritta senza parentesi:

<basic restr> ::=
     <value>
| <op><value>
| NOT <basic restr>
| ( <restr> )

Una restrizione è un valore di ricerca, ad esempio un valore numerico o stringa, facoltativamente con un operatore. I moduli validi per una restrizione sono i seguenti:

<restr> ::=
    <basic restr>
| <restr> AND <restr>
| <restr> <restr>      // Same as <restr> AND <restr>
| <restr> OR <restr>

Se non si specifica un operatore, Windows Search sceglie l'operatore più appropriato per la query:

• Per una proprietà stringa, viene utilizzato l'operatore $ COP_WORD_STARTSWITH< .
• Per tutte le altre proprietà, viene utilizzato l'operatore COP_EQUAL = .

Per l'uso programmatico di AQS, è consigliabile avere sempre un operatore esplicito. Il modulo valido per la ricerca di un valore semplice o un intervallo di valori è il seguente:

<value> ::=
    <simplevalue>
| <simplevalue> .. <simplevalue>

Un valore semplice può essere costituito da uno dei tipi seguenti:

<simplevalue> ::=
  []         // No value, or a null value
| <word>     // A sequence of characters without whitespace
| <number>   // An integer or a floating point number
| <datetime> // A relative date, or an absolute date and/or time
| <Boolean>
| "..."      // A phrase
| <enumeration range>

Esempi

Una query che cerca un documento contenente la fase "last quarter", creata da Theresa o Lee e salvata nella cartella MyDocs, combina tre query di base come indicato di seguito:

"last quarter" author:(theresa OR lee) folder:MyDocs

Le tre query di base sono:

• "ultimo trimestre"
• author:(theresa OR lee)
• folder:MyDocs

Una query di base che usa la sintassi canonica è:

System.Size:>1kb

Proprietà

Le proprietà vengono definite da una parola chiave, che può essere un nome di proprietà canonico in Windows 7 e versioni successive. AQS nell'interfaccia utente di Windows può usare l'etichetta anziché il nome della proprietà canonica, ad esempio autore anziché System.Author. In Windows Vista e versioni precedenti era possibile usare le etichette in inglese indipendentemente dalla lingua dell'interfaccia utente. In Windows 7 e versioni successive Windows Search riconosce le parole chiave solo nella lingua predefinita corrente dell'interfaccia utente.

Supporto per le proprietà personalizzate

In Windows Vista e versioni precedenti le proprietà personalizzate non erano disponibili in AQS. In Windows 7 e versioni successive, AQS funziona con proprietà personalizzate registrate nel sistema di proprietà. Per altre informazioni sulla creazione di proprietà personalizzate, vedere Sistema di proprietà.

Proprietà DateTime in Windows 8

A partire da Windows 8, le proprietà DateTime (ad esempio System.DateModified) supportano il formato di data e ora canonico specificato da ISO-8601, includendo facoltativamente il fuso orario UTC.

• Windows 8 e versioni precedenti, data-ora senza fuso orario UTC: AAAA-MM-GGThh:mm:ss

  Questo formato specifica un'ora locale, indipendentemente dalle impostazioni locali dell'utente o del sistema.

• Windows 8, data/ora con fuso orario UTC: AAAA-MM-GGThh:mm:ssTZD

  Questo formato specifica un'ora nel fuso orario UTC specificato.

Uso delle parole chiave nei linguaggi locali

In Windows 7 e versioni successive, le parole chiave mnemonic funzionano solo nella lingua di sistema, ad esempio parole chiave tedesche solo in un sistema operativo tedesco e parole chiave inglese solo in un sistema operativo inglese. System.Author è una parola chiave canonica e il valore mnemonico per la proprietà System.Author, ad esempio, è Author. L'introduzione delle parole chiave canoniche compensa il fatto che le parole chiave mnemonic inglesi non vengono più riconosciute universalmente in tutti i sistemi operativi indipendentemente dalla lingua, come nel caso di Windows Vista e versioni precedenti.

Sintassi di query avanzate canoniche in Windows 7

La sintassi canonica è stata introdotta per le parole chiave in Windows 7. Un esempio di query con una proprietà canonica è System.Message.FromAddress:=me@microsoft.com. Quando si codificano query nelle applicazioni in esecuzione in Windows 7 e versioni successive, è necessario usare la sintassi canonica per generare query AQS a livello di codice. Se non si usa la sintassi canonica e l'applicazione viene distribuita in un linguaggio di impostazioni locali o di interfaccia utente diverso dal linguaggio nel codice dell'applicazione, le query non verranno interpretate correttamente.

Le convenzioni per la sintassi delle parole chiave canoniche sono le seguenti:

• La sintassi canonica per una proprietà è il nome canonico, ad esempio System.Photo.LightSource. I nomi canonici non fanno distinzione tra maiuscole e minuscole.
• La sintassi canonica per gli operatori booleani è costituita dalle parole chiave AND, OR e NOT, in tutte le maiuscole.
• Gli operatori <, , >= e così via, non vengono localizzati e quindi fanno parte anche della sintassi canonica.
• Se una proprietà P ha enumerato valori o intervalli denominati N₁ tramite Nk, la sintassi canonica per il valore o l'intervallo Iè il nome canonico per P, seguito dal carattere #, seguito da N I, come illustrato nell'esempio seguente:
  • System.Photo.LightSource#Daylight, System.Photo.LightSource#StandardAe così via.
• Per un tipo semantico definito T con valori o intervalli denominati N₁ tramite Nk, la sintassi canonica per il valore o l'intervallo Iè il nome canonico per T, seguito dal carattere #, seguito da N_, come illustrato nell'esempio seguente:
  • System.Devices.LaunchDeviceStageFromExplorer:=System.StructuredQueryType.Boolean#True
• Per i valori letterali, ad esempio parole o frasi, la sintassi canonica corrisponde alla sintassi regolare. Esempi di query con valori letterali nella sintassi canonica sono:
  • System.Author:sanjay
  • System.Keywords:"Animal"
  • System.FileCount:>100

Esempi

La tabella seguente illustra alcuni esempi di proprietà canoniche e la sintassi per usarle.

Per altre informazioni sulle proprietà canoniche e sul sistema di proprietà in genere, vedere Proprietà di sistema. In alternativa, fare riferimento ai file di intestazione pubblica.

Operatori di query

Se una proprietà, p, ha più valori per alcuni elementi, una query AQS per p:<restr> restituisce l'elemento se <restr> è true per almeno uno dei valori. (<restr> rappresenta una restrizione).

La sintassi elencata nella tabella seguente è costituita da un operatore, un simbolo di operatore, un esempio e una descrizione di esempio. L'operatore e il simbolo possono essere usati in qualsiasi linguaggio e inclusi in qualsiasi query. Non usare gli operatori COP_IMPLICIT o COP_APPLICATION_SPECIFIC. Alcuni operatori hanno simboli intercambiabili.

¹ Parentesi quadre vuote ([]) denotano "no value".

Per le proprietà stringa, l'operazione predefinita è COP_WORD_STARTS_WITH o COP_WORD_EQUAL.

Valori di query

Esempi utili del modo in cui i valori di query possono essere limitati sono elencati nella tabella seguente.

Restrizioni di ambito

Gli utenti possono limitare l'ambito delle ricerche a percorsi di cartelle o archivi dati specifici. Ad esempio, se si utilizzano diversi account di posta elettronica e si desidera limitare una query a Microsoft Outlook o Microsoft Outlook Express, è possibile utilizzare System.Search.Store:mapi o System.Search.Store:oe rispettivamente. La tabella seguente illustra alcuni esempi di come limitare una ricerca in base all'archivio dati.

Risorse aggiuntive

• In Windows 7 e versioni successive, un'opzione di menu di scelta rapida può essere disponibile in base al fatto che venga soddisfatta una condizione AQS. Per altre informazioni, vedere "Getting Dynamic Behavior for Static Verbs by Using Advanced Query Syntax" in Creating Context Menu Handlers .
• Le query AQS possono essere limitate a tipi specifici di file, noti come tipi di file. Per altre informazioni, vedere Tipi di file e associazioni. Per la documentazione di riferimento sulle proprietà, vedere System.Kind e System.KindText.

Argomenti correlati

Esecuzione di query sull'indice a livello di codice

Uso di approcci SQL e AQS per eseguire query sull'indice

Esecuzione di query sull'indice con ISearchQueryHelper

Esecuzione di query sull'indice con il protocollo search-ms

Esecuzione di query sull'indice con la sintassi SQL di Windows Search