CachedFileUpdaterUI.FileUpdateRequested Événement

Définition

Espace de noms:

Windows.Storage.Provider

Se déclenche lorsque Windows demande une mise à jour de fichier. Cet événement se déclenche une fois pour chaque mise à jour demandée.

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

Type d'événement

TypedEventHandler<CachedFileUpdaterUI,FileUpdateRequestedEventArgs>

Exemples

L’exemple de contrats du sélecteur de fichiers montre comment répondre à un événement 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 contient un objet FileUpdateRequestedEventArgs .

Remarques

Si votre application participe au contrat Mise à jour de fichiers mis en cache, vous devez vous inscrire à cet événement dans le gestionnaire d’événements activé de votre application où vous case activée pour ActivationKind.CachedFileUpdater. Vous devez répondre à cet événement FileUpdateRequested en mettant à jour le fichier et en définissant fileUpdateRequest.Status de la demande. Utilisez cachedFileUpdaterUI. Propriété UpdateTarget pour déterminer si votre application doit mettre à jour le fichier de version dans son dépôt ou la copie mise en cache localement du fichier en réponse à la demande.

Vous pouvez accéder aux informations sur la mise à jour demandée à l’aide de la propriété FileUpdateRequestedEventArgs.Request sur l’objet passé à votre gestionnaire d’événements FileUpdateRequested. 

Si vous avez besoin d’une entrée utilisateur pour terminer la mise à jour, définissez FileUpdateRequest.Status sur FileUpdateStatus.UserInputNeeded et terminez la demande. Si l’interaction utilisateur est disponible, un autre FichierUpdateRequested se déclenche et votre application peut obtenir l’entrée de l’utilisateur et terminer la demande.