TargetFileRequestDeferral Classe

Définition

Espace de noms:

Windows.Storage.Pickers.Provider

Utilisé par une application qui fournit un emplacement d’enregistrement pour indiquer de manière asynchrone que l’application a terminé de répondre à un événement TargetFileRequested .

public ref class TargetFileRequestDeferral sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class TargetFileRequestDeferral final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class TargetFileRequestDeferral

Public NotInheritable Class TargetFileRequestDeferral

Héritage

Object Platform::Object IInspectable TargetFileRequestDeferral

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 sélecteur de fichiers montre comment répondre à un gestionnaire d’événements TargetFileRequested, notamment comment obtenir un report.

// Event handler
private async void OnTargetFileRequested(FileSavePickerUI sender, TargetFileRequestedEventArgs e)
{
    // Respond to TargetFileRequested event on the background thread on which it was raised

    // Requesting a deferral allows the app to call another asynchronous method and complete the request at a later time
    var deferral = e.Request.GetDeferral();

    // Create file and assign to TargetFile property
    e.Request.TargetFile = await ApplicationData.Current.LocalFolder.CreateFileAsync(sender.FileName, CreationCollisionOption.GenerateUniqueName);

    // Complete the deferral to let the Picker know the request is finished
    deferral.Complete();
}

// Register for the event
fileSavePickerUI.TargetFileRequested += new TypedEventHandler<FileSavePickerUI, TargetFileRequestedEventArgs>(OnTargetFileRequested);

Dans l’exemple, e contient un objet TargetFileRequestedEventArgs .

Remarques

Si votre application participe au contrat Sélecteur d’enregistrement de fichiers et qu’un événement TargetFileRequested se déclenche, votre application doit créer un storageFile qui représente le fichier que l’utilisateur souhaite enregistrer. Le nom du StorageFile que vous créez doit correspondre au nom du fichier spécifié par la propriété FileName . Le StorageFile que vous créez est retourné à l’application qui a appelé le sélecteur de fichiers (l’application appelante) afin que l’application appelante puisse écrire du contenu dans le fichier. En savoir plus sur la réponse à cet événement dans targetFileRequestedEventArgs.

Votre application, en tant que fournisseur d’un emplacement d’enregistrement, peut signaler qu’elle a terminé sa réponse asynchrone à un événement TargetFileRequested en appelant targetFileRequestDeferral.complete. En savoir plus sur la réponse asynchrone à un événement TargetFileRequested dans TargetFileRequestedEventArgs.

Méthodes

Complete()

Signale que l’application fournissant l’emplacement d’enregistrement a terminé de répondre à un événement TargetFileRequested .