Поделиться через


Класс ChangeApplicationServices

Представляет объект службы применения изменений, который можно использовать для выполнения отдельных действий по применению изменений.

Пространство имен: Microsoft.Synchronization
Сборка: Microsoft.Synchronization (в microsoft.synchronization.dll)

Синтаксис

'Декларация
Public Class ChangeApplicationServices
'Применение
Dim instance As ChangeApplicationServices
public class ChangeApplicationServices
public ref class ChangeApplicationServices
public class ChangeApplicationServices
public class ChangeApplicationServices

Замечания

Объект ChangeApplicationServices является частью службы применения изменений платформы Sync Framework, которая используется в том случае, если для поставщику необходима большая гибкость, чем обеспечивается стандартным объектом применения изменений, предусмотренным платформой Sync Framework. Например, поставщик должен откладывать применение определенных изменений до завершения сеанса синхронизации. Стандартный объект применения изменений этого не позволяет. Поставщик может использовать службу применения изменений для обработки обнаружения конфликтов и вычисления набора знаний, сохранив способность откладывать изменения в случае необходимости.

Для поставщика, которому не требуется дополнительная гибкость службы применения изменений, может оказаться проще пользоваться стандартным объектом применения изменений, например NotifyingChangeApplier.

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

  1. Создайте и инициализируйте новый объект ChangeApplicationServices.

  2. Запустите обработку пакета изменений, вызвав метод BeginChangeApplication, или запустите обработку пакета изменений для синхронизации восстановления, вызвав метод BeginFullEnumerationChangeApplication. Обычно этот метод вызывается один раз для каждого обрабатываемого пакета изменений.

  3. Выполните перечисление изменений в пакете. Вызовите метод GetChangeApplicationContext по одному разу для каждого изменения и пользуйтесь для применения изменений возвращенным объектом ChangeApplicationContext.

  4. Сообщите об успешном применении изменений, вызвав метод ReportItemChangeApplied или ReportChangeUnitChangeApplied. Сообщите о неуспешном применении изменений, вызвав метод ReportRecoverableErrorOnItemChange или ReportRecoverableErrorOnChangeUnitChange.

  5. Вызовите метод GetUpdatedDestinationKnowledge в любое время, чтобы получить обновленный набор знаний назначения, содержащий все изменения, примененные на данный момент.

  6. Завершите обработку пакета изменений, вызвав метод EndChangeApplication, или завершите обработку пакета изменений для синхронизации восстановления, вызвав метод EndFullEnumerationChangeApplication. Сохраните обновленные объекты набора знаний назначения и утраченного набора знаний назначения, возвращенные этим методом.

  7. Повторите шаги с 3 по 7 для каждого пакета изменений, полученного поставщиком назначения.

Иерархия наследования

System.Object
  Microsoft.Synchronization.ChangeApplicationServices

Многопоточное использование

Все общие статические члены (Shared в Visual Basic) можно использовать в многопоточных операциях. Безопасная многопоточная работа с членами экземпляров типа не гарантируется.

См. также

Справочник

Элементы ChangeApplicationServices
Пространство имен Microsoft.Synchronization