FileSavePickerUI.TargetFileRequested Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se activa cuando el usuario confirma que se va a guardar un archivo en el selector de archivos.
// Register
event_token TargetFileRequested(TypedEventHandler<FileSavePickerUI, TargetFileRequestedEventArgs const&> const& handler) const;
// Revoke with event_token
void TargetFileRequested(event_token const* cookie) const;
// Revoke with event_revoker
FileSavePickerUI::TargetFileRequested_revoker TargetFileRequested(auto_revoke_t, TypedEventHandler<FileSavePickerUI, TargetFileRequestedEventArgs const&> const& handler) const;public event TypedEventHandler<FileSavePickerUI,TargetFileRequestedEventArgs> TargetFileRequested;function onTargetFileRequested(eventArgs) { /* Your code */ }
fileSavePickerUI.addEventListener("targetfilerequested", onTargetFileRequested);
fileSavePickerUI.removeEventListener("targetfilerequested", onTargetFileRequested);
- or -
fileSavePickerUI.ontargetfilerequested = onTargetFileRequested;Public Custom Event TargetFileRequested As TypedEventHandler(Of FileSavePickerUI, TargetFileRequestedEventArgs) Tipo de evento
Ejemplos
En el ejemplo del selector de archivos se muestra cómo responder a un controlador de eventos 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);
En el ejemplo, e contiene un objeto TargetFileRequestedEventArgs .
Comentarios
Si la aplicación participa en el contrato selector de guardado de archivos y se desencadena un evento TargetFileRequested, la aplicación debe crear un nuevo StorageFile que represente el archivo que el usuario quiere guardar. El nombre del archivo StorageFile que cree debe coincidir con el nombre del archivo especificado por la propiedad FileName . StorageFile que cree se devuelve a la aplicación que llamó al selector de archivos (la aplicación que realiza la llamada) para que la aplicación que realiza la llamada pueda escribir contenido en el archivo. Obtenga más información sobre cómo responder a este evento en targetFileRequestedEventArgs.
Nota
La interfaz de usuario del selector de archivos está deshabilitada hasta que la aplicación de suministro haya terminado de responder a este evento.