CachedFileUpdaterUI.FileUpdateRequested Evento

Definizione

Spazio dei nomi:

Windows.Storage.Provider

Viene generato quando Windows richiede un aggiornamento di file. Questo evento viene generato una volta per ogni aggiornamento richiesto.

// 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 evento

TypedEventHandler<CachedFileUpdaterUI,FileUpdateRequestedEventArgs>

Esempio

L'esempio di contratti di selezione file illustra come rispondere a un 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 contiene un oggetto FileUpdateRequestedEventArgs .

Commenti

Se l'app partecipa al contratto Aggiornamento file memorizzato nella cache, è necessario registrarsi per questo evento nel gestore eventi attivato dell'app in cui si verifica la presenza di ActivationKind.CachedFileUpdater. È necessario rispondere a questo evento FileUpdateRequested aggiornando il file e impostando FileUpdateRequest.Status della richiesta. Usare CachedFileUpdaterUI. Proprietà UpdateTarget per determinare se l'app deve aggiornare il file di versione nel relativo repository o la copia memorizzata nella cache locale del file in risposta alla richiesta.

È possibile accedere alle informazioni sull'aggiornamento richiesto usando la proprietà FileUpdateRequestedEventArgs.Request nell'oggetto passato al gestore eventi FileUpdateRequested. 

Se è necessario l'input utente per completare l'aggiornamento, impostare FileUpdateRequest.Status su FileUpdateStatus.UserInputNeeded e completare la richiesta. Se l'interazione utente è disponibile, un altro FileUpdateRequested verrà attivato e l'app può ottenere l'input utente e completare la richiesta.