FileUpdateRequest Classe

Définition

Espace de noms:

Windows.Storage.Provider

Fournit des informations sur une mise à jour de fichier demandée afin que l’application puisse terminer la demande.

public ref class FileUpdateRequest sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileUpdateRequest final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileUpdateRequest

Public NotInheritable Class FileUpdateRequest

Héritage

Object Platform::Object IInspectable FileUpdateRequest

Attributs

ContractVersionAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple de contrats du sélecteur de fichiers montre comment répondre à un événement FileUpdateRequested, notamment comment utiliser Request pour obtenir fileUpdateRequest.

// 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 De mise à jour de fichiers mis en cache, utilisez cette classe pour répondre lorsque Windows déclenche des événements FileUpdateRequested pour demander des mises à jour de fichiers. Vous pouvez accéder à cette classe à partir de votre gestionnaire d’événements à l’aide de FileUpdateRequestedEventArgs. Propriété request . Dans le cadre de votre réponse à un événement FileUpdateRequested, vous devez définir la propriété Status de cette classe pour indiquer la status de la mise à jour.

En savoir plus sur la réponse aux demandes de mise à jour dans FileUpdateRequested et FileUpdateRequestedEventArgs.

Si votre application ne peut pas terminer la mise à jour avant de retourner à partir de son gestionnaire d’événements FileUpdateRequested , vous pouvez utiliser la propriété GetDeferral pour terminer la mise à jour de manière asynchrone.

Propriétés

ContentId	Obtient l’identificateur unique utilisé pour associer la version locale d’un fichier à la version distante correspondante.
File	Obtient un objet StorageFile qui représente la copie mise en cache localement du fichier à mettre à jour.
Status	Obtient ou définit la status de la mise à jour. Cette propriété est définie en réponse à un événement FileUpdateRequested .
UserInputNeededMessage	Obtient ou définit un message à l’utilisateur indiquant que l’entrée de l’utilisateur est nécessaire pour terminer la demande FileUpdateRequest.

Méthodes

GetDeferral()	Obtient un objet utilisé pour effectuer une mise à jour de manière asynchrone.
UpdateLocalFile(IStorageFile)	Fournissez une nouvelle version du fichier local pour représenter le fichier distant.