Класс ChangeApplicationServices
Представляет объект службы применения изменений, который можно использовать для выполнения отдельных действий по применению изменений.
Пространство имен: Microsoft.Synchronization
Сборка: Microsoft.Synchronization (в Microsoft.Synchronization.dll)
Синтаксис
'Декларация
Public Class ChangeApplicationServices
'Применение
Dim instance As ChangeApplicationServices
public class ChangeApplicationServices
public ref class ChangeApplicationServices
type ChangeApplicationServices = class end
public class ChangeApplicationServices
Замечания
Объект ChangeApplicationServices является частью службы применения изменений платформы Sync Framework, которая используется в том случае, если для поставщику необходима большая гибкость, чем обеспечивается стандартным объектом применения изменений, предусмотренным платформой Sync Framework. Например, поставщик должен откладывать применение определенных изменений до завершения сеанса синхронизации. Стандартный объект применения изменений этого не позволяет. Поставщик может использовать службу применения изменений для обработки обнаружения конфликтов и вычисления набора знаний, сохранив способность откладывать изменения в случае необходимости.
Для поставщика, которому не требуется дополнительная гибкость службы применения изменений, может оказаться проще пользоваться стандартным объектом применения изменений, например NotifyingChangeApplier.
Служба применения изменений обычно используется поставщиком назначения в рамках реализации методов ProcessChangeBatch и ProcessFullEnumerationChangeBatch. Для использования службы применения изменений выполните следующие действия.
Создайте и инициализируйте новый объект ChangeApplicationServices.
Запустите обработку пакета изменений, вызвав метод BeginChangeApplication, или запустите обработку пакета изменений для синхронизации восстановления, вызвав метод BeginFullEnumerationChangeApplication. Обычно этот метод вызывается один раз для каждого обрабатываемого пакета изменений.
Выполните перечисление изменений в пакете. Вызовите метод GetChangeApplicationContext по одному разу для каждого изменения и пользуйтесь для применения изменений возвращенным объектом ChangeApplicationContext.
Сообщите об успешном применении изменений, вызвав метод ReportItemChangeApplied или ReportChangeUnitChangeApplied. Сообщите о неуспешном применении изменений, вызвав метод ReportRecoverableErrorOnItemChange или ReportRecoverableErrorOnChangeUnitChange.
В любое время можно вызвать метод GetUpdatedDestinationKnowledge, чтобы получить обновленный набор знаний назначения, содержащий все изменения, примененные на данный момент.
Завершите обработку пакета изменений, вызвав метод EndChangeApplication, или завершите обработку пакета изменений для синхронизации восстановления, вызвав метод EndFullEnumerationChangeApplication. Сохраните обновленные объекты набора знаний назначения и утраченного набора знаний назначения, возвращенные этим методом.
Повторите шаги с 3 по 7 для каждого пакета изменений, полученного поставщиком назначения.
Иерархия наследования
System. . :: . .Object
Microsoft.Synchronization..::..ChangeApplicationServices
Потоковая защита
Все открытые статический (Shared в Visual Basic) элементы этого типа потокобезопасны. Потокобезопасность элементов экземпляров не гарантируется.