TargetFileRequestDeferral Klasse

Referenz

Definition

Namespace:: Windows.Storage.Pickers.Provider

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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: ContractVersionAttribute

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:

Freigeben über