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 per ogni tentativo. Se ad esempio si tenta di eliminare una cartella e nella cartella è presente un file, il tentativo non riuscirà. Il tentativo di eliminazione della cartella verrà ripetuto nel corso della sessione fino a quando l'operazione di eliminazione verrà completata oppure si determinerà che l'operazione di eliminazione non può essere eseguita durante la sessione corrente e verrà ignorata.
Questo evento verrà generato solo se una modifica influisce sui dati dei file della replica di destinazione e non se influisce solo sui metadati di un file. Se ad esempio viene rilevato un conflitto aggiornamento-aggiornamento e si sceglie di mantenere il file 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