FileSavePickerUI.TargetFileRequested Ereignis

Definition

Namespace:

Windows.Storage.Pickers.Provider

Wird ausgelöst, wenn der Benutzer eine Datei committet, die in der Dateiauswahl gespeichert werden soll.

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

Ereignistyp

TypedEventHandler<FileSavePickerUI,TargetFileRequestedEventArgs>

Beispiele

Das Beispiel für die Dateiauswahl veranschaulicht, wie auf einen TargetFileRequested-Ereignishandler reagiert wird.

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

Enthält im Beispiel e ein TargetFileRequestedEventArgs-Objekt .

Hinweise

Wenn Ihre App am Vertrag Dateispeicherauswahl teilnimmt und ein TargetFileRequested-Ereignis ausgelöst wird, sollte Ihre App eine neue StorageFile-Datei erstellen, die die Datei darstellt, die der Benutzer speichern möchte. Der Name des von Ihnen erstellten StorageFile-Objekts muss mit dem Namen der Datei übereinstimmen, die durch die FileName-Eigenschaft angegeben wird. Das von Ihnen erstellte StorageFile wird an die App zurückgegeben, die die Dateiauswahl (die aufrufende App) aufgerufen hat, damit die aufrufende App Inhalte in die Datei schreiben kann. Weitere Informationen zum Reagieren auf dieses Ereignis finden Sie in targetFileRequestedEventArgs.

Hinweis

Die Benutzeroberfläche der Dateiauswahl ist deaktiviert, bis die bereitstellende App auf dieses Ereignis reagiert hat.

Weitere Informationen

• FileSavePickerUI
• TargetFileRequestedEventArgs
• StorageFile