CachedFileUpdaterUI.FileUpdateRequested Evento

Definição

Namespace:

Windows.Storage.Provider

É acionado quando o Windows solicita uma atualização de arquivo. Esse evento é acionado uma vez para cada atualização solicitada.

// Register
event_token FileUpdateRequested(TypedEventHandler<CachedFileUpdaterUI, FileUpdateRequestedEventArgs const&> const& handler) const;

// Revoke with event_token
void FileUpdateRequested(event_token const* cookie) const;

// Revoke with event_revoker
CachedFileUpdaterUI::FileUpdateRequested_revoker FileUpdateRequested(auto_revoke_t, TypedEventHandler<CachedFileUpdaterUI, FileUpdateRequestedEventArgs const&> const& handler) const;

public event TypedEventHandler<CachedFileUpdaterUI,FileUpdateRequestedEventArgs> FileUpdateRequested;

function onFileUpdateRequested(eventArgs) { /* Your code */ }
cachedFileUpdaterUI.addEventListener("fileupdaterequested", onFileUpdateRequested);
cachedFileUpdaterUI.removeEventListener("fileupdaterequested", onFileUpdateRequested);
- or -
cachedFileUpdaterUI.onfileupdaterequested = onFileUpdateRequested;

Public Custom Event FileUpdateRequested As TypedEventHandler(Of CachedFileUpdaterUI, FileUpdateRequestedEventArgs) 

Tipo de evento

TypedEventHandler<CachedFileUpdaterUI,FileUpdateRequestedEventArgs>

Exemplos

O exemplo de contratos do seletor de arquivos demonstra como responder a um evento FileUpdateRequested.

// Event handler
void CachedFileUpdaterUI_FileUpdateRequested(CachedFileUpdaterUI sender, FileUpdateRequestedEventArgs args)
{
    fileUpdateRequest = args.Request;
    fileUpdateRequestDeferral = fileUpdateRequest.GetDeferral();
    switch (cachedFileUpdaterUI.UIStatus)
    {
        case UIStatus.Hidden:
            fileUpdateRequest.Status = FileUpdateStatus.UserInputNeeded;
            fileUpdateRequestDeferral.Complete();
            break;
        case UIStatus.Visible:
            break;
        case UIStatus.Unavailable:
            fileUpdateRequest.Status = FileUpdateStatus.Failed;
            fileUpdateRequestDeferral.Complete();
            break;
    }
}

// Register for the event
cachedFileUpdaterUI.FileUpdateRequested += CachedFileUpdaterUI_FileUpdateRequested;

args contém um objeto FileUpdateRequestedEventArgs .

Comentários

Se o aplicativo participar do contrato do Atualizador de Arquivos Armazenados em Cache, você deverá se registrar para esse evento no manipulador de eventos ativado do aplicativo em que você marcar para ActivationKind.CachedFileUpdater. Você deve responder a esse evento FileUpdateRequested atualizando o arquivo e definindo FileUpdateRequest.Status da solicitação. Use o CachedFileUpdaterUI. Propriedade UpdateTarget para determinar se seu aplicativo deve atualizar o arquivo de versão em seu repositório ou a cópia localmente armazenada em cache do arquivo em resposta à solicitação.

Você pode acessar informações sobre a atualização solicitada usando a propriedade FileUpdateRequestedEventArgs.Request no objeto que é passado para o manipulador de eventos FileUpdateRequested. 

Se você precisar de entrada do usuário para concluir a atualização, defina FileUpdateRequest.Status como FileUpdateStatus.UserInputNeeded e conclua a solicitação. Se a interação do usuário estiver disponível, outro FileUpdateRequested será acionado e seu aplicativo poderá obter a entrada do usuário e concluir a solicitação.