FileUpdateRequest Classe

Référence

Définition

Espace de noms:: Windows.Storage.Provider

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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.

S’applique à

Partager via