SyncCollectionRequest

SyncCollectionRequest class

Класс содержит команды и параметры, применимые к определенной коллекции.

public class SyncCollectionRequest

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

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

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

ИмяОписание
CollectionId { get; set; }Указывает идентификатор сервера папки для синхронизации.
Commands { get; set; }Содержит операции, которые применяются к коллекции. Доступные операции: «Добавить», «Удалить», «Изменить», «Выбрать» и «Мягкое удаление».
ConversationMode { get; set; }Указывает, следует ли включать элементы, включенные в модальность беседы, в результаты ответа синхронизации. Установка значения элемента ConversationMode в значение TRUE приводит к получению всех сообщений электронной почты, соответствующих беседам, полученным в рамках указанного фильтра дат. Однако, несмотря на то, что тело сообщений электронной почты за пределами этого временного фильтра не будет получено, предварительный просмотр текста будет получен, если предварительный просмотр был запрошен. Установка значения элемента ConversationMode на FALSE в запросе синхронизации приводит к синхронизации элементы, соответствующие критериям значения элемента FilterType (раздел 2.2.3.64). Установка для элемента ConversationMode значения TRUE расширяет результирующий набор, чтобы также включить любые элементы с идентичными значениями email2:ConversationId ([MS-ASEMAIL], раздел 2.2.2.14) тем, которые находятся в результирующем наборе FilterType. Значение элемента ConversationMode не влияет на элементы вне коллекции, указанной элементом CollectionId (раздел 2.2.3.30.5); результирующий набор всегда ограничен элементами указанной коллекции. Значение элемента ConversationMode только ограничивает или расширяет результаты, определенные значением элемента FilterType.
DeletesAsMoves { get; set; }Запросы, указывающие на то, что любые удаленные элементы СЛЕДУЕТ переместить в папку «Удаленные». Если для элемента DeletesAsMoves установлено значение false, удаление является необратимым. Если клиент хочет окончательно удалить элементы, запрос ДОЛЖЕН включать элемент DeletesAsMoves со значением FALSE. Значение TRUE, используемое по умолчанию, указывает, что все удаленные элементы перемещаются в папку «Удаленные».
GetChanges { get; set; }Запрашивает, чтобы сервер включил в свой ответ любые ожидающие изменения в коллекции, указанной элементом ServerId (раздел 2.2.3.151.6). Если со времени последней синхронизации произошли изменения, ответ сервера включает элемент Commands (раздел 2.2.3.32) , который содержит добавления, удаления и изменения. Если клиент не хочет, чтобы возвращались изменения сервера, запрос ДОЛЖЕН включать элемент GetChanges со значением FALSE. Значение TRUE указывает, что клиент хочет, чтобы изменения сервера были возвращены. Значение TRUE предполагается, когда элемент GetChanges пуст. Если в запросе отсутствует элемент GetChanges, поведение зависит от значения элемента SyncKey, как указано в разделе 2.2.3.166.4. Если элемент SyncKey имеет значение 0, то запрос обрабатывается так, как если бы для элемента GetChanges было установлено значение FALSE. Если элемент SyncKey имеет ненулевое значение, то запрос обрабатывается так, как если бы элемент GetChanges был установлен на ИСТИНА.
Options { get; }Задает параметры, управляющие определенными аспектами выполнения синхронизации. Допустимое количество 0…2. Параметры синхронизации позволяют клиенту указать параметры усечения и содержимого. Эти настройки инкапсулированы в дочерний элемент airsyncbase:BodyPreference, как указано в разделе 2.2.2.7 [MS-ASAIRS]. Поскольку параметры синхронизации указаны для коллекции, клиент может указать уникальное значение элемента airsyncbase:BodyPreference для каждой синхронизируемой коллекции. Дополнительные сведения об элементе airsyncbase:BodyPreference см. в разделе 2.2 [MS-ASAIRS]. 2.7. Сервер сохраняет блок опций между запросами, используя концепцию, называемую «закрепленными опциями». Если блок Options не включен в запрос, используется предыдущий блок Options. Всякий раз, когда клиент указывает новые параметры, включая блок параметров в запрос, сервер ДОЛЖЕН заменить исходный блок параметров новым блоком параметров. Если два элемента параметров включены в один запрос команды синхронизации, один из элементов параметров ДОЛЖЕН укажите параметры синхронизации для класса SMS, а другой элемент Options задает параметры для класса по умолчанию для данной папки.
Supported { get; }Элементы класса Contact и класса Calendar, которые не являются фантомными, могут быть включены в качестве дочерних элементов элемента Supported. Подробнее об использовании скрытых свойств см. в разделе 2.2.3.154.
SyncKey { get; set; }Значение SyncKey используется сервером для обозначения состояния синхронизации коллекции. Ключ синхронизации со значением 0 (ноль) инициализирует состояние синхронизации на сервере и вызывает полную синхронизацию коллекции.
WindowSize { get; set; }Указывает максимальное количество измененных элементов в коллекции или запросе, которые СЛЕДУЕТ включать в ответ синхронизации. Если WindowSize не определен, сервер ведет себя так, как если бы был отправлен элемент WindowSize со значением 100. Сервер интерпретирует значение 0 (ноль) и значения выше 512 как 512.

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

SyncChangeServerOperation SyncCollectionResponse