Partager via

TargetFileRequestedEventArgs Classe

  • Référence

Définition

Espace de noms:
Windows.Storage.Pickers.Provider
Modifier

Fournit des informations sur un événement TargetFileRequested .

public ref class TargetFileRequestedEventArgs sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class TargetFileRequestedEventArgs final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class TargetFileRequestedEventArgs
Public NotInheritable Class TargetFileRequestedEventArgs
Héritage
Object Platform::Object IInspectable TargetFileRequestedEventArgs
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 événement TargetFileRequested.

// 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

Cet objet est passé au gestionnaire d’événements pour les événements TargetFileRequested .

Réponse à un événement TargetFileRequested

Si votre application participe au contrat sélecteur d’enregistrement de fichiers et qu’un événement TargetFileRequested se déclenche, votre application doit répondre en procédant comme suit :

  1. Obtenez une requête TargetFileRequest à l’aide de la propriété TargetFileRequestedEventArgs.request .
  2. Créez (ou récupérez) un StorageFile pour représenter le fichier à enregistrer ; ce StorageFile est retourné à l’application qui a appelé le sélecteur de fichiers à enregistrer et utilisé par l’application appelante pour écrire du contenu dans le fichier.

Le nom de fichier et l’extension de l’objet qui représente le fichier doivent correspondre au nom et à l’extension de fichier spécifiés par l’utilisateur (et accessibles via FileName) ou la tentative d’enregistrement du fichier échoue. Si la tentative échoue, l’utilisateur peut réessayer d’enregistrer le fichier.

Si votre application (en tant que fournisseur de l’emplacement d’enregistrement) ne peut pas fournir d’objet pour le fichier à enregistrer, définissez TargetFileRequest.TargetFile sur Null.

  1. Définissez TargetFileRequest.TargetFile sur l’objet StorageFile .

Réponse asynchrone

Si votre application, qui fournit l’emplacement d’enregistrement, ne peut pas terminer de répondre à l’événement TargetFileRequested avant qu’il ne retourne à partir de son gestionnaire d’événements (par exemple, si votre application appelle une méthode asynchrone), vous pouvez terminer votre réponse de manière asynchrone en différé.

Votre application, en tant que fournisseur de l’emplacement d’enregistrement, peut différer pour répondre à l’événement de manière asynchrone en procédant comme suit :

  1. Obtenez une requête TargetFileRequest à l’aide de la propriété TargetFileRequestedEventArgs.request .
  2. Appelez TargetFileRequest.GetDeferral pour obtenir un objet TargetFileRequestDeferral .
  3. Effectuez les étapes nécessaires pour répondre à l’événement TargetFileRequested (décrit dans la section précédente).
  4. Appelez TargetFileRequestDeferral.Complete pour signaler que votre application a terminé de répondre à l’événement TargetFileRequested .

Propriétés

Request

Obtient un objet TargetFileRequest utilisé pour répondre à un événement TargetFileRequested .

S’applique à

Voir aussi