SearchOptions

SearchOptions class

Содержит параметры поиска. Имя пользователя и пароль могут быть отправлены в запросе только после получения значения состояния 14. Серверу требуются эти учетные данные для доступа к запрошенным ресурсам. Клиент ДОЛЖЕН отправлять их только через безопасное или доверенное соединение и только в ответ на значение Status, равное 14. Поддерживаемые параметры зависят от хранилища, в котором выполняется поиск. В следующей таблице перечислены допустимые параметры для каждого хранилища. GAL: Range, UserName, Password, Picture Почтовый ящик: Range, DeepTraversal, RebuildResults, BodyPreference, BodyPartPreference, RightsManagementSupport командные запросы, которые включают ConversationId.

public class SearchOptions

Конструкторы

ИмяОписание
SearchOptions()Конструктор по умолчанию.

Характеристики

ИмяОписание
BodyPartPreference { get; }Содержит информацию о предпочтениях, связанную с типом и размером информации, возвращаемой при поиске, синхронизации или извлечении части сообщения.
BodyPreference { get; }Содержит информацию о предпочтениях, связанную с типом и размером информации, возвращаемой при поиске, синхронизации или извлечении.
DeepTraversal { get; set; }Указывает, что клиент хочет, чтобы сервер выполнял поиск во всех подпапках папок, указанных в запросе.
MIMESupport { get; set; }Включает поддержку MIME для элементов электронной почты, отправляемых с сервера клиенту. airsyncbase:BodyPreference, тип, ДОЛЖЕН быть включен в запрос поиска, содержащий значение «MIME» (4), чтобы сообщить серверу, что устройство может прочитать MIME BLOB. — ответ от сервера ДОЛЖЕН включать airsyncbase:Body, который является дочерним элементом свойств. airsyncbase:Body ДОЛЖЕН содержать следующие свойства в ответе поиска S/MIME: :EstimatedDataSize, чтобы указать приблизительный общий размер данных. - Airsyncbase:Truncated, чтобы указать, усечен ли MIME BLOB. - airsyncbase:Данные, содержащие полный MIME BLOB.
Password { get; set; }Указывает пароль для данного имени пользователя. Значение пароля имеет максимальную длину 100 символов.
Picture { get; set; }Содержит данные, связанные с запросом фотографий. Изображение не поддерживается при версии протокола 12.1 или 14.0.
Range { get; set; }Задает максимальное количество возвращаемых совпадающих записей. Формат значения элемента Range имеет форму описателя индекса, отсчитываемого от нуля, состоящего из нуля, дефиса и другого числового значения: «mn». m указывает наименьший индекс массива с отсчетом от нуля, который будет содержать элементы. n указывает самый высокий индекс массива с отсчетом от нуля, который будет содержать элементы. Например, значение элемента Range от 0 до 9 указывает на 10 элементов, а от 0 до 10 — на 11 элементов. Значение элемента Range от 0 до 0 указывает на 1 элемент. Если Range имеет значение null, используется значение Range по умолчанию для каждого типа Store. В следующей таблице указаны значения диапазона по умолчанию и максимальные результаты, возвращаемые для каждого типа хранилища: Mailbox — значение диапазона по умолчанию: 0–99 — максимальное количество возвращаемых результатов: 100 DocumentLibrary — значение диапазона по умолчанию: 0–999 — максимальное количество возвращаемых результатов : 1000 GAL — значение диапазона по умолчанию: 0–99 — максимальное количество возвращаемых результатов: 100 Если значение диапазона, указанное в запросе, превышает значение диапазона по умолчанию, возвращается значение состояния 12, указывающее, что максимальный диапазон превышен. В ответе на команду поиска свойство Total указывает оценку общего количества записей, соответствующих значению запроса. Результаты поиска сохраняются в папке поиска на сервере. Таким образом, когда клиент возвращается с тем же запросом, но с новым диапазоном строк, строки извлекаются из набора результатов, который в настоящее время хранится в папке поиска. Весь набор результатов не нужно перестраивать.
RebuildResults { get; set; }Заставляет сервер перестроить папку поиска (2), соответствующую заданному запросу. Результаты поиска (то есть набор результатов) сохраняются в папке поиска на сервере. Таким образом, когда клиент возвращается с тем же запросом, но с новым диапазоном строк, строки извлекаются из набора результатов, который в настоящее время хранится в папке поиска. Весь набор результатов перестраивать не нужно. Папка поиска остается неизменной до тех пор, пока клиент не выполнит одно из следующих действий для обновления набора результатов: — отправляет запрос на поиск с указанием нового запроса. В этом случае папка поиска автоматически перестраивается. Узел RebuildResults включать необязательно. — отправляет поисковый запрос, включающий узел RebuildResults. В этом случае сервер вынужден перестроить папку поиска. Если добавляется новый элемент, он не появляется в наборе результатов до тех пор, пока набор результатов не будет обновлен. Если элемент удален, сервер отфильтрует удаленный элемент из набора результатов. Клиенту СЛЕДУЕТ отправлять новый поисковый запрос с заданным запросом и включать параметр RebuildResults каждые несколько дней, чтобы обеспечить точные результаты для этого запроса.
RightsManagementSupport { get; set; }Указывает, как сервер возвращает сообщения электронной почты с управляемыми правами клиенту. Если значение равно TRUE, сервер распаковывает и расшифровывает сообщения электронной почты с управляемыми правами перед их отправкой клиенту. Если значение равно FALSE, сервер не будет распаковывать или расшифровывать сообщения электронной почты с управляемыми правами перед их отправкой клиенту. Если элемент RightsManagementSupport не включен в сообщение запроса, предполагается значение по умолчанию FALSE.
UserName { get; set; }Указывает учетную запись пользователя, используемую для поиска документа в библиотеке документов. Значение UserName может иметь длину до 100 символов.

Смотрите также

SearchCondition SearchQuery