CachedFileUpdaterUI.FileUpdateRequested | fileupdaterequested event

Fires when the Windows requests a file update. This event fires once for each requested update.

Syntax

public:
event TypedEventHandler<CachedFileUpdaterUI, FileUpdateRequestedEventArgs>^ FileUpdateRequested {
   Windows::Foundation::EventRegistrationToken add(TypedEventHandler<CachedFileUpdaterUI, FileUpdateRequestedEventArgs>^ value);
   void remove(Windows::Foundation::EventRegistrationToken token);
}

Event information

Remarks

If your app participates in the Cached File Updater contract, you must register for this event in your app's activated event handler where you check for ActivationKind.CachedFileUpdater. You must respond to this FileUpdateRequested event by updating the file and setting the FileUpdateRequest.Status of the request. Use the CachedFileUpdaterUI.UpdateTarget property to determine whether your app should update the version file in its repository or the locally cached copy of the file in response to the request.

You can access information about the requested update by using the FileUpdateRequestedEventArgs.Request property on the object that is passed to your FileUpdateRequested event handler. 

If you need user input to complete the update, set the FileUpdateRequest.Status to FileUpdateStatus.UserInputNeeded and complete the request. If user interaction is available, another FileUpdateRequested will fire and your app can obtain user input and complete the request.

Examples

The File picker contracts sample demonstrates how to respond to a FileUpdateRequested event.

Both args and e (in C# and JS respectively) contain a FileUpdateRequestedEventArgs object.

Requirements

See also

CachedFileUpdaterUI

Build date: 12/4/2012