Événement ApplyingChange
Se produit lorsqu'une modification de fichier est sur le point d'être tentée.
Espace de noms : Microsoft.Synchronization.Files
Assembly : Microsoft.Synchronization.Files (dans Microsoft.Synchronization.Files.dll)
Syntaxe
'Déclaration
Public Event ApplyingChange As EventHandler(Of ApplyingChangeEventArgs)
'Utilisation
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);
}
member ApplyingChange : IEvent<EventHandler<ApplyingChangeEventArgs>,
ApplyingChangeEventArgs>
Notes
Cet événement fournit à l'application un mécanisme permettant d'omettre dynamiquement des modifications pendant une session de synchronisation. Pour ignorer une modification, attribuez à la propriété SkipChange la valeur true. Une modification ignorée n'est pas appliquée au réplica de destination. Un événement SkippedChange est déclenché avec SkippedChangeEventArgs..::..SkipReason ayant comme valeur ApplicationRequest pour chaque modification ignorée.
Certaines modifications sont tentées plusieurs fois au cours d'une session. À chaque tentative, cet événement est déclenché. Par exemple, une tentative est effectuée pour supprimer un dossier. Parce qu'il y a un fichier existant dans le dossier, la tentative échoue. Cette opération de suppression de dossiers continue d'être tentée pendant toute la session jusqu'au succès de l'opération de suppression ou tant qu'il n'a pas été déterminé que l'opération de suppression ne peut pas avoir lieu pendant cette session et est ignorée.
Cet événement est déclenché uniquement lorsqu'une modification affecte les données du fichier sur le réplica de destination et non lorsqu'une modification affecte seulement les métadonnées d'un fichier. Par exemple, si un conflit de mise à jour de mise à jour est détecté et que le fichier sur le système de destination est choisi en tant que vainqueur, aucune modification n'est appliquée à la destination et cet événement n'est pas déclenché. De même, propager un objet tombstone de la source à la destination se traduit par la mise à jour des seules métadonnées et aucune modification n'est apportée au système de fichiers de destination. Dans ce cas, cet événement n'est pas déclenché.
La classe ApplyingChangeEventArgs fournit le type de modification, les données de fichier actuelles, les données de fichier telles qu'elles seront si la modification est appliquée, et la propriété SkipChange. Cette propriété peut être utilisée pour ignorer dynamiquement cette modification.