Evento FileSyncProvider.ApplyingChange

Viene generato quando si tenta di apportare una modifica a un file.

Spazio dei nomi: Microsoft.Synchronization.Files
Assembly: Microsoft.Synchronization.Files (in microsoft.synchronization.files.dll)

Sintassi

'Dichiarazione
Public Event ApplyingChange As EventHandler(Of ApplyingChangeEventArgs)
'Utilizzo
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.

Osservazioni

Questo evento fornisce un meccanismo che consente all'applicazione di ignorare in modo dinamico le modifiche durante una sessione di sincronizzazione. Per ignorare una modifica, impostare la proprietà SkipChange su true. Una modifica ignorata non verrà applicata nella replica di destinazione. Per ogni modifica ignorata verrà generato un evento SkippedChange con SkippedChangeEventArgs.SkipReason impostato su ApplicationRequest.

Nel corso di una sessione è possibile che si tenti di apportare alcune modifiche più di una volta. L'evento viene generato a ogni tentativo. Se ad esempio si tenta di eliminare una cartella e nella cartella è presente un file, il tentativo avrà esito negativo. Il tentativo di eliminazione della cartella verrà ripetuto nel corso della sessione finché l'operazione di eliminazione non verrà completata oppure non verrà stabilito che l'operazione di eliminazione non può essere eseguita durante la sessione corrente e quindi verrà ignorata.

Questo evento verrà generato solo se una modifica incide sui dati dei file nella replica di destinazione e non se incide solo sui metadati di un file. Se ad esempio viene rilevato un conflitto aggiornamento-aggiornamento e il file prevalente è quello presente nel sistema di destinazione, non verrà applicata alcuna modifica alla destinazione e l'evento non verrà generato. Analogamente, la propagazione di una rimozione definitiva dall'origine alla destinazione causa solo un aggiornamento dei metadati e nessuna modifica al file system di destinazione. In questo caso l'evento non verrà generato.

La classe ApplyingChangeEventArgs fornisce il tipo di modifica, i dati del file correnti, i dati del file successivamente all'applicazione della modifica e la proprietà SkipChange. Questa proprietà può essere utilizzata per ignorare la modifica in modo dinamico.

Vedere anche

Riferimento

Classe FileSyncProvider
Membri FileSyncProvider
Spazio dei nomi Microsoft.Synchronization.Files