TargetFileRequestedEventArgs Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece informações sobre um evento 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 TargetFileRequestedEventArgsPublic NotInheritable Class TargetFileRequestedEventArgs- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Exemplos
O exemplo de seletor de arquivo demonstra como responder a um evento 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);
No exemplo, e contém um objeto TargetFileRequestedEventArgs.
Comentários
Esse objeto é passado para o manipulador de eventos para eventos TargetFileRequested .
Respondendo a um evento TargetFileRequested
Se o aplicativo participar do contrato do Seletor de Salvamento de Arquivos e um evento TargetFileRequested for acionado , seu aplicativo deverá responder seguindo estas etapas:
- Obtenha um TargetFileRequest usando a propriedade TargetFileRequestedEventArgs.request .
- Criar (ou recuperar) um StorageFile para representar o arquivo a ser salvo; este StorageFile é retornado ao aplicativo que chamou o seletor de arquivos para salvar e usado pelo aplicativo de chamada para gravar conteúdo no arquivo.
O nome do arquivo e a extensão do objeto que representa o arquivo devem corresponder ao nome do arquivo e à extensão especificados pelo usuário (e acessíveis por meio de FileName) ou a tentativa de salvar o arquivo falhará. Se a tentativa falhar, o usuário poderá tentar salvar o arquivo novamente.
Se o aplicativo (como o provedor do local de salvamento) não puder fornecer um objeto para o arquivo salvar, defina TargetFileRequest.TargetFile como nulo.
- Defina TargetFileRequest.TargetFile como o objeto StorageFile .
Respondendo de forma assíncrona
Se o aplicativo, que está fornecendo o local de salvamento, não puder concluir a resposta ao evento TargetFileRequested antes que ele retorne de seu manipulador de eventos (por exemplo, se o aplicativo chamar um método assíncrono), você poderá concluir sua resposta de forma assíncrona adiando.
Seu aplicativo, como o provedor do local de salvamento, pode adiar para responder ao evento de forma assíncrona seguindo estas etapas:
- Obtenha um TargetFileRequest usando a propriedade TargetFileRequestedEventArgs.request .
- Chame TargetFileRequest.GetDeferral para obter um objeto TargetFileRequestDeferral .
- Execute as etapas necessárias para responder ao evento TargetFileRequested (descrito na seção anterior).
- Chame TargetFileRequestDeferral.Complete para sinalizar que seu aplicativo terminou de responder ao evento TargetFileRequested .
Propriedades
| Request |
Obtém um objeto TargetFileRequest usado para responder a um evento TargetFileRequested . |