Condividi tramite


TargetFileRequestedEventArgs Classe

Definizione

Fornisce informazioni su un 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 TargetFileRequestedEventArgs
Public NotInheritable Class TargetFileRequestedEventArgs
Ereditarietà
Object Platform::Object IInspectable TargetFileRequestedEventArgs
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

L'esempio di selezione file illustra come rispondere a un 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);

Nell'esempio e contiene un oggetto TargetFileRequestedEventArgs.

Commenti

Questo oggetto viene passato al gestore eventi per gli eventi TargetFileRequested .

Risposta a un evento TargetFileRequested

Se l'app partecipa al contratto selezione salvataggio file e viene generato un evento TargetFileRequested , l'app deve rispondere seguendo questa procedura:

  1. Ottenere un oggetto TargetFileRequest usando la proprietà TargetFileRequestedEventArgs.request .
  2. Creare (o recuperare) un oggetto StorageFile per rappresentare il file da salvare; StorageFile viene restituito all'app che ha chiamato la selezione file per salvare e usare l'app chiamante per scrivere contenuto nel file.

Il nome file e l'estensione dell'oggetto che rappresenta il file devono corrispondere al nome e all'estensione specificati dall'utente (e accessibili tramite FileName) oppure il tentativo di salvare il file avrà esito negativo. Se il tentativo non riesce, l'utente può provare a salvare di nuovo il file.

Se l'app (come provider del percorso di salvataggio) non può fornire un oggetto per il file da salvare, impostare TargetFileRequest.TargetFile su null.

  1. Impostare TargetFileRequest.TargetFile sull'oggetto StorageFile .

Risposta asincrona

Se l'app, che fornisce il percorso di salvataggio, non riesce a rispondere all'evento TargetFileRequested prima che restituisca dal relativo gestore eventi (ad esempio, se l'app chiama un metodo asincrono), puoi completare la risposta in modo asincrono rinviando la risposta.

L'app, come provider del percorso di salvataggio, può rinviare per rispondere all'evento in modo asincrono seguendo questa procedura:

  1. Ottenere un oggetto TargetFileRequest usando la proprietà TargetFileRequestedEventArgs.request .
  2. Chiamare TargetFileRequest.GetDeferral per ottenere un oggetto TargetFileRequestDeferral .
  3. Eseguire i passaggi necessari per rispondere all'evento TargetFileRequested (descritto nella sezione precedente).
  4. Chiama TargetFileRequestDeferral.Complete per segnalare che l'app ha terminato di rispondere all'evento TargetFileRequested .

Proprietà

Request

Ottiene un oggetto TargetFileRequest utilizzato per rispondere a un evento TargetFileRequested .

Si applica a

Vedi anche