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。略過的變更將不會套用到目的地複寫。如果每一個略過的變更都將 SkippedChangeEventArgs.SkipReason 設定為 ApplicationRequest，將會引發 SkippedChange 事件。

在工作階段進行期間，某些變更將會嘗試一次以上。在每一次嘗試時，都會引發這個事件。例如，嘗試刪除資料夾。因為資料夾中已經有檔案，所以此嘗試動作會失敗。在整個工作階段期間，將會繼續嘗試這個資料夾刪除作業，直到刪除作業成功，或是判斷出此工作階段期間無法進行刪除作業而且略過此作業為止。

只有當變更會影響目的地複寫上的檔案資料時，這個事件才會引發；當變更只會影響檔案的中繼資料時，則不會引發。例如，如果偵測到更新與更新之間的衝突，而且目的地系統上的檔案被選為贏家，則不會將任何變更套用到目的地，也不會引發這個事件。同樣地，從來源將標記傳播到目的地只會造成中繼資料更新，而不會變更目的地檔案系統。在此情況中，不會引發這個事件。

ApplyingChangeEventArgs 類別會提供變更的類型、目前的檔案資料、套用變更時的檔案資料及 SkipChange 屬性。這個屬性可用來動態略過此變更。

請參閱

參考

FileSyncProvider 類別
FileSyncProvider 成員
Microsoft.Synchronization.Files 命名空間