Lire en anglais

Partager via


FileUpdateRequest Classe

Définition

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

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 à