TargetFileRequestDeferral class

Used by an app that provides a save location to indicate asynchronously that the app is finished responding to a targetfilerequested event.

Syntax

var targetFileRequestDeferral = targetFileRequest.getDeferral();

Attributes

VersionAttribute(NTDDI_WIN8)

Members

The TargetFileRequestDeferral class has these types of members:

• Methods

Methods

The TargetFileRequestDeferral class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

Remarks

If your app participates in the File Save Picker contract and a targetfilerequested event fires, your app should create a new storageFile that represents the file the user wants to save. The name of the storageFile you create must match the name of the file specified by the fileName property. The storageFile you create is returned to the app that called the file picker (the calling app) so that the calling app can write content to the file. Learn more about responding to this event in targetFileRequestedEventArgs.

Your app, as the provider of a save location, can signal that it has finished its asynchronous response to a targetfilerequested event by calling targetFileRequestDeferral.complete. Learn more about responding asynchronously to a targetfilerequested event in targetFileRequestedEventArgs.

Examples

The File picker sample demonstrates how to respond to a targetfilerequested event handler, including how to get a deferral.

// Event handler
function onTargetFileRequested(e) {
    var deferral;
    deferral = e.request.getDeferral();

    // Create a file to pass to the file picker which then gives it to the calling app
    Windows.Storage.ApplicationData.current.localFolder.createFileAsync(fileSavePickerUI.fileName).done(function (file) {
            // Assign the resulting file to the targetFile property and complete the deferral to indicate success
        e.request.targetFile = file;
        deferral.complete();
    }, function () {
        // Set the targetFile property to null and complete the deferral to indicate failure
        e.request.targetFile = null;
        deferral.complete();
    });
};

// Register for the event
fileSavePickerUI.addEventListener("targetfilerequested", onTargetFileRequested, false);

In the example, e contains a TargetFileRequestedEventArgs object.

Requirements

See also

FileSavePickerUI.TargetFileRequested event

TargetFileRequest class

TargetFileRequestDeferral class

TargetFileRequestDeferral.Complete method

TargetFileRequestedEventArgs class

Windows.Storage.StorageFile class

Build date: 12/4/2012