Evento FileSyncProvider.ApplyingChange

Ocorre quando uma alteração de arquivo está prestes a ser tentada.

Namespace: Microsoft.Synchronization.Files
Assembly: Microsoft.Synchronization.Files (em microsoft.synchronization.files.dll)

Sintaxe

'Declaração
Public Event ApplyingChange As EventHandler(Of ApplyingChangeEventArgs)
'Uso
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.

Comentários

Este evento fornece um mecanismo para o aplicativo ignorar, dinamicamente, as alterações durante uma sessão de sincronização. Para ignorar uma alteração, defina a propriedade SkipChange como true. Uma alteração ignorada não será aplicada à réplica de destino. Um evento SkippedChange será disparado com SkippedChangeEventArgs.SkipReason definido como ApplicationRequest para cada alteração que for ignorada.

Algumas alterações são tentadas mais de uma vez durante uma sessão. Em cada tentativa, este evento é disparado. Por exemplo, é feita uma tentativa de exclusão de uma pasta. Como existe um arquivo na pasta, a tentativa falha. Essa operação de exclusão de pasta continua a ser tentada durante toda a sessão até que a operação de exclusão seja executada ou até que seja determinado que essa operação não pode ocorrer durante esta sessão e ela seja ignorada.

Este evento só será gerado quando uma alteração afetar os dados do arquivo na réplica de destino, e não quando uma alteração afetar apenas os metadados de um arquivo. Por exemplo, se um conflito da atualização-atualização for detectado e o arquivo no sistema de destino for escolhido como o vencedor, nenhuma alteração será aplicada ao destino e este evento não será disparado. De forma semelhante, a propagação de uma marca de exclusão da origem para o destino causa apenas uma atualização de metadados e nenhuma alteração no sistema de arquivos de destino. Neste caso, este evento não será disparado.

A classe ApplyingChangeEventArgs fornece o tipo da alteração, dados do arquivo atual, dados do arquivo como serão quando a alteração for aplicada e a propriedade SkipChange. Essa propriedade pode ser usada para ignorar, dinamicamente, esta alteração.

Consulte também

Referência

Classe FileSyncProvider
Membros FileSyncProvider
Namespace Microsoft.Synchronization.Files