Freigeben über


TargetFileRequestDeferral Klasse

Definition

Wird von einer App verwendet, die einen Speicherort bereitstellt, um asynchron anzugeben, dass die App beendet ist, um auf ein TargetFileRequested-Ereignis zu reagieren.

public ref class TargetFileRequestDeferral sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class TargetFileRequestDeferral final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class TargetFileRequestDeferral
Public NotInheritable Class TargetFileRequestDeferral
Vererbung
Object Platform::Object IInspectable TargetFileRequestDeferral
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Das Beispiel für die Dateiauswahl veranschaulicht, wie auf einen TargetFileRequested-Ereignishandler reagiert wird , einschließlich des Abrufens einer Verzögerung.

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

Ihre App als Anbieter eines Speicherspeicherorts kann signalisieren, dass sie ihre asynchrone Antwort auf ein TargetFileRequested-Ereignis beendet hat, indem sie targetFileRequestDeferral.complete aufruft. Erfahren Sie mehr über das asynchrone Reagieren auf ein TargetFileRequested-Ereignis in TargetFileRequestedEventArgs.

Methoden

Complete()

Signalisiert, dass die App, die den Speicherort bereitstellt, auf ein TargetFileRequested-Ereignis reagiert hat .

Gilt für: