TargetFileRequestDeferral Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Storage.Pickers.Provider

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Usato da un'app che fornisce un percorso di salvataggio per indicare in modo asincrono che l'app ha terminato di rispondere a un evento TargetFileRequested .

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

Ereditarietà: Object Platform::Object IInspectable TargetFileRequestDeferral

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 ottenere un differitore.

// 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 e contiene un oggetto TargetFileRequestedEventArgs .

Commenti

Se l'app partecipa al contratto selezione salvataggio file e viene generato un evento TargetFileRequested , l'app deve creare un nuovo oggetto StorageFile che rappresenta il file che l'utente vuole salvare. Il nome di StorageFile 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.

L'app, come provider di un percorso di salvataggio, può segnalare che ha terminato la risposta asincrona a un evento TargetFileRequested chiamando targetFileRequestDeferral.complete. Altre informazioni sulla risposta asincrona a un evento TargetFileRequested in TargetFileRequestedEventArgs.

Metodi

Complete()

Segnala che l'app che fornisce la posizione di salvataggio è stata completata rispondendo a un evento TargetFileRequested .

Si applica a

Condividi tramite