Share via

Событие FileSyncProvider.ApplyingChange

  • Статья

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

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

Синтаксис

'Декларация
Public Event ApplyingChange As EventHandler(Of ApplyingChangeEventArgs)
'Применение
Dim instance As FileSyncProvider
Dim handler As EventHandler(Of ApplyingChangeEventArgs)

AddHandler instance.ApplyingChange, handler

public event EventHandler<ApplyingChangeEventArgs> ApplyingChange

public:
event EventHandler<ApplyingChangeEventArgs^>^ ApplyingChange {
    void add (EventHandler<ApplyingChangeEventArgs^>^ value);
    void remove (EventHandler<ApplyingChangeEventArgs^>^ value);
}

/** @event */
public void add_ApplyingChange (EventHandler<ApplyingChangeEventArgs> value)

/** @event */
public void remove_ApplyingChange (EventHandler<ApplyingChangeEventArgs> value)

JScript supports the use of events, but not the declaration of new ones.

Замечания

Это событие предоставляет возможность динамически пропускать в приложении изменения во время сеанса синхронизации. Чтобы пропустить изменение, присвойте свойству SkipChange значение true. Пропущенное изменение не будет применяться к реплике назначения. Событие SkippedChange будет активизироваться с параметром SkippedChangeEventArgs.SkipReason, заданным равным ApplicationRequest, применительно к каждому пропущенному изменению.

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

Это событие вызывается только в том случае, если изменение затрагивает данные файла в реплике назначения, и не вызывается, если изменение затрагивает только метаданные для файла. Например, если обнаружен конфликт операций обновления и победителем выбран файл в системе назначения, то в системе назначения изменения не применяются и это событие вызвано не будет. Аналогично, в ходе передачи отметки полного удаления от источника к назначению происходит только обновление метаданных, а в файловой системе назначения не происходят изменения. В таком случае это событие не активируется.

Класс ApplyingChangeEventArgs предоставляет сведения о типе изменения, о данных текущего файла, о том, какими должны стать данные в случае применения изменения, а также о свойстве SkipChange. Это свойство может использоваться для динамического пропуска этого изменения.

См. также

Справочник

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