Использование расширенного синтаксиса запросов программным способом

Расширенный синтаксис запросов (AQS) — это синтаксис запросов по умолчанию, используемый поиском Windows для запроса индекса и уточнения и узких параметров поиска. AQS используется разработчиками для программного создания запросов (и пользователей для ограничения параметров поиска). Канонические AQS появились в Windows 7 и должны использоваться в Windows 7 и более поздних версиях для программного создания запросов AQS.

Этот раздел организован следующим образом:

• О расширенном синтаксисе запросов
  • Примеры
  • Свойства
• Использование ключевых слов на локальных языках
• Канонический расширенный синтаксис запросов в Windows 7
  • Примеры
  • Операторы запросов
  • Значения запросов
• Ограничения области
• Дополнительные ресурсы
• Связанные статьи

О расширенном синтаксисе запросов

Запрос состоит из основных запросов, связанных с AND, OR и NOT, как показано в следующем примере синтаксиса:

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

Если запрос имеет два или более использования AND или OR, они привязываются слева направо независимо от того, имеет ли он значение AND или OR. То есть запрос "apple AND pear OR plum" будет интерпретирован как "(яблоко И груша) ИЛИ слива", и запрос "apple OR pear AND plum" будет интерпретирован как "(яблоко ИЛИ груша) И слива". Поэтому если документ содержит слово слива, но ни яблоко, ни груша, первый запрос вернет его, но второй запрос не будет. Поэтому мы рекомендуем использовать явные скобки для любого запроса, который смешивает AND и OR, чтобы избежать ошибок или неправильного понимания.

Базовый запрос ищет элементы, удовлетворяющие ограничению для свойства. Единственной необходимой частью базового запроса является ограничение или значение поиска. Если свойство не указано, поиск Windows выполняет поиск по всем свойствам. <restr> представляет ограничение поиска.

Допустимы следующие формы для базового запроса:

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

Свойство определяется ключевым словом, таким как автор или размер, или каноническим именем свойства, например System.DateModified. Допустимые формы для свойства:

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

Оператор указывает операцию, например < или =. Список допустимых операторов см. в разделе "Операторы запросов" далее в этом разделе.

Базовое ограничение — это простое ограничение для свойства, которое можно записать без скобок:

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

Ограничение — это значение поиска, например числовой или строковое значение, при необходимости с оператором. Допустимые формы ограничения приведены ниже.

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

Если оператор не указан, поиск Windows выбирает наиболее подходящий оператор для запроса:

• Для строкового свойства предполагается использование оператора COP_WORD_STARTSWITH $<.
• Для всех остальных свойств предполагается оператор COP_EQUAL = .

Для использования AQS в программировании рекомендуется всегда явно указывать оператор. Допустимая форма поиска простого значения или диапазона значений выглядит следующим образом:

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

Простое значение может состоять из любого из следующих типов:

<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>

Примеры

Запрос, который выполняет поиск документа, содержащего этап "последний квартал", созданного Терсой или Ли, и который был сохранен в папке MyDocs, объединяет три основных запроса следующим образом:

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

Ниже приведены три основных запроса:

• "последний квартал"
• автор:(Тереза ИЛИ Ли)
• папка:MyDocs

Базовый запрос, использующий канонический синтаксис:

System.Size:>1kb

Свойства

Свойства ссылаются на ключевое слово, которое может быть каноническим именем свойства в Windows 7 и более поздних версиях. AQS в пользовательском интерфейсе Windows может использовать метку вместо канонического имени свойства, например автора вместо System.Author. В Windows Vista и более ранних версиях можно было использовать английские метки независимо от языка пользовательского интерфейса. В Windows 7 и более поздних версиях поиск Windows распознает ключевые слова только на текущем языке пользовательского интерфейса по умолчанию.

Поддержка настраиваемых свойств

В Windows Vista и более ранних версиях пользовательские свойства недоступны в AQS. В Windows 7 и более поздних версиях AQS работает с пользовательскими свойствами, зарегистрированными в системе свойств. Дополнительные сведения о создании настраиваемых свойств см. в разделе "Система свойств".

Свойства DateTime в Windows 8

По состоянию на Windows 8 свойства DateTime (например , System.DateModified) поддерживают канонический формат даты и времени, указанный ISO-8601, при необходимости включая часовой пояс UTC.

• Windows 8 и более ранние версии, формат даты и времени без часового пояса UTC:ГГГГ-ММ-ДДTчч:мм:сс

  Этот формат задает локальное время независимо от языкового стандарта пользователя или системы.

• Windows 8, дата и время в формате UTC:ГГГГ-ММ-ДДThh:мм:ssTZD

  Этот формат указывает время в указанном часовом поясе UTC.

Использование ключевых слов на локальных языках

В Windows 7 и более поздних версиях ключевые слова mnemonic работают только на системном языке, такие как немецкие ключевые слова только в немецкой операционной системе, а также ключевые слова английского языка только в английской операционной системе. System.Author — это каноническое ключевое слово, и мнемоническое значение свойства System.Author — например, Author. Введение канонических ключевых слов сглаживает тот факт, что английские мнемонические ключевые слова больше не являются универсально распознаваемыми во всех операционных системах независимо от языка, как это было в Windows Vista и более ранних версиях.

Канонический расширенный синтаксис запросов в Windows 7

Канонический синтаксис был представлен для ключевых слов в Windows 7. Пример запроса с каноническим свойством System.Message.FromAddress:[email protected]. При написании запросов в приложениях, работающих в Windows 7 и более поздних версиях, необходимо использовать канонический синтаксис для программного создания запросов AQS. Если вы не используете канонический синтаксис и приложение развертывается в языковом стандарте или языке пользовательского интерфейса, отличном от языка в коде приложения, ваши запросы не будут интерпретироваться правильно.

Соглашения для канонического синтаксиса ключевых слов приведены следующим образом:

• Канонический синтаксис свойства — это его каноническое имя, например System.Photo.LightSource. Канонические имена не учитывает регистр.
• Стандартный синтаксис логических операторов состоит из ключевых слов AND, OR и NOT, написанных заглавными буквами.
• Операторы <, >=и т. д. не локализованы и поэтому являются частью канонического синтаксиса.
• Если свойство P имеет перечисленные значения или диапазоны с именем N₁ по Nk, канонический синтаксис для I-го значения или диапазона представляется каноническим именем P, за которым следует символ #, а затем _{N_I}, как показано в следующем примере.
  • System.Photo.LightSource#Daylight, System.Photo.LightSource#StandardAи т. д.
• Для определенного семантического типа T со значениями или диапазонами, названными N₁ через Nₖ, каноническим синтаксисом для значения или диапазона I является каноническое имя T, а затем символ #, а затем N_I, как показано в следующем примере.
  • System.Devices.LaunchDeviceStageFromExplorer:=System.StructuredQueryType.Boolean#True
• Для литеральных значений, таких как слова или фразы, канонический синтаксис совпадает с обычным синтаксисом. Примеры запросов с литеральными значениями в каноническом синтаксисе:
  • System.Author:sanjay
  • System.Keywords:"Animal"
  • System.FileCount:>100

Примеры

В следующей таблице показаны некоторые примеры канонических свойств и синтаксис для их использования.

Дополнительные сведения о канонических свойствах и системе свойств, как правило, см. в разделе "Свойства системы". Кроме того, обратитесь к общедоступным файлам заголовков.

Операторы запроса

Если свойство p имеет несколько значений для некоторого элемента, запрос AQS для p:<restr> возвращает элемент, если <restr> имеет значение true по крайней мере для одного из значений. (<restr> представляет ограничение.)

Синтаксис, указанный в следующей таблице, состоит из оператора, символа оператора, примера и примера описания. Оператор и символ могут использоваться на любом языке и включаться в любой запрос. Не используйте операторы COP_IMPLICIT или COP_APPLICATION_SPECIFIC. Некоторые операторы имеют взаимозаменяемые символы.

¹ Пустые квадратные скобки ([]) указывают "нет значения".

Для строковых свойств операция, выполняемая по умолчанию, — это COP_WORD_STARTS_WITH или COP_WORD_EQUAL.

Значения запросов

Полезные примеры ограничения значений запросов перечислены в следующей таблице.

Ограничения области

Пользователи могут ограничить область поиска определенными расположениями папок или хранилищами данных. Например, если вы используете несколько учетных записей электронной почты и хотите ограничить запрос microsoft Outlook или Microsoft Outlook Express, можно использовать System.Search.Store:mapi или System.Search.Store:oe соответственно. В следующей таблице показаны некоторые примеры ограничения поиска по хранилищу данных.

Дополнительные ресурсы

• В Windows 7 и более поздних версиях элемент контекстного меню может появиться в зависимости от того, выполнено ли условие AQS. Дополнительные сведения см. в разделе "Получение динамического поведения для статических команд с помощью расширенного синтаксиса запроса" в разделе "Создание обработчиков контекстного меню".
• Запросы AQS могут быть ограничены определенными типами файлов, которые называются типами файлов. Дополнительные сведения см. в разделе "Типы файлов и связи". Документацию по свойствам см. в System.Kind и System.KindText.

Связанные темы

Отправка программных запросов к индексу

Использование подходов SQL и AQS для запроса индекса

Запрос индекса с помощью ISearchQueryHelper

Запрос индекса с помощью протокола search-ms

Запрос индекса с помощью синтаксиса SQL поиска Windows