TargetFileRequest Classe

Definizione

Spazio dei nomi:

Windows.Storage.Pickers.Provider

Consente a un'app che fornisce un percorso di salvataggio specificare StorageFile che rappresenta il file da salvare e ottenere un rinvio in modo che l'app possa rispondere in modo asincrono a un evento TargetFileRequested .

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

Ereditarietà

Object Platform::Object IInspectable TargetFileRequest

Attributi

ContractVersionAttribute

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 gestore eventi TargetFileRequested, incluso come usare la proprietà Request per ottenere 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);

Nell'esempio contiene e un oggetto TargetFileRequestedEventArgs .

Commenti

Se l'app partecipa al contratto Selezione file e viene generato un evento Targetfilerequested , l'app deve creare un nuovo File di archiviazione che rappresenta il file che l'utente vuole salvare. Il nome del file di archiviazione creato deve corrispondere al nome del file specificato dalla proprietà FileName . StorageFile creato viene restituito all'app che ha chiamato la selezione file (l'app chiamante) in modo che l'app chiamante possa scrivere contenuto nel file. Altre informazioni sulla risposta a questo evento in TargetFileRequestedEventArgs.

Proprietà

TargetFile

Ottiene o imposta l'oggetto IStorageFile fornito per rappresentare il file da salvare dall'app che fornisce il percorso di salvataggio.

Metodi

GetDeferral()

Ottiene un oggetto TargetFileRequestDeferral che l'app che fornisce la posizione di salvataggio può usare per rispondere in modo asincrono a un evento TargetFileRequested .