FileUpdateRequest Classe
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.
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
- Attributs
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)
|
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 .
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.
Content |
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 . |
User |
Obtient ou définit un message à l’utilisateur indiquant que l’entrée de l’utilisateur est nécessaire pour terminer la demande FileUpdateRequest. |
Get |
Obtient un objet utilisé pour effectuer une mise à jour de manière asynchrone. |
Update |
Fournissez une nouvelle version du fichier local pour représenter le fichier distant. |