TargetFileRequest 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

Ermöglicht einer App, die einen Speicherort bereitstellt, die StorageFile angibt, die die zu speichernde Datei darstellt und eine Verzögerung erhält, damit die App asynchron auf ein TargetFileRequested-Ereignis reagieren kann.

public ref class TargetFileRequest sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class TargetFileRequest final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class TargetFileRequest

Public NotInheritable Class TargetFileRequest

Vererbung: Object Platform::Object IInspectable TargetFileRequest

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

Im Beispiel für die Dateiauswahl wird veranschaulicht, wie auf einen TargetFileRequested-Ereignishandler reagiert wird , einschließlich der Verwendung der Request-Eigenschaft zum Abrufen der TargetFileRequest.The File picker sample how to respond to a TargetFileRequest event handler, including how to use the Request property to get the TargetFileRequest.

// 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 der von Ihnen erstellten StorageFile-Datei muss mit dem Namen der Datei übereinstimmen, die von der FileName-Eigenschaft angegeben wird. Die von Ihnen erstellte StorageFile-Datei wird an die App zurückgegeben, die die Dateiauswahl aufgerufen hat (die aufrufende App), damit die aufrufende App Inhalte in die Datei schreiben kann. Weitere Informationen zum Reagieren auf dieses Ereignis finden Sie in TargetFileRequestedEventArgs.

Eigenschaften

TargetFile

Ruft das IStorageFile-Objekt ab, das bereitgestellt wird, um die datei darzustellen, die von der App gespeichert werden soll, die den Speicherort bereitstellt.

Methoden

GetDeferral()

Ruft ein TargetFileRequestDeferral-Objekt ab, das die App, die den Speicherort bereitstellt, verwenden kann, um asynchron auf ein TargetFileRequested-Ereignis zu reagieren.

Gilt für:

Freigeben über