TargetFileRequest Classe
Définition
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.
Permet à une application qui fournit un emplacement d’enregistrement de spécifier le StorageFile qui représente le fichier à enregistrer et à obtenir un report afin que l’application puisse répondre de manière asynchrone à un événement TargetFileRequested .
public ref class TargetFileRequest sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class TargetFileRequest final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class TargetFileRequest
Public NotInheritable Class TargetFileRequest
- Héritage
- Attributs
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 utiliser la propriété Request pour obtenir le TargetFileRequest.
// 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.
Propriétés
TargetFile |
Obtient ou définit l’objet IStorageFile fourni pour représenter le fichier à enregistrer par l’application qui fournit l’emplacement d’enregistrement. |
Méthodes
GetDeferral() |
Obtient un TargetFileRequestDeferral que l’application fournissant l’emplacement d’enregistrement peut utiliser pour répondre de manière asynchrone à un événement TargetFileRequested . |