TargetFileRequestDeferral Classe

Definição

Namespace:

Windows.Storage.Pickers.Provider

Usado por um aplicativo que fornece um local de salvamento para indicar de forma assíncrona que o aplicativo terminou de responder a um 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

Herança

Object Platform::Object IInspectable TargetFileRequestDeferral

Atributos

ContractVersionAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo do seletor de arquivos demonstra como responder a um manipulador de eventos TargetFileRequested , incluindo como obter um adiamento.

// 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);

No exemplo, e contém um objeto TargetFileRequestedEventArgs .

Comentários

Se o aplicativo participar do contrato do Seletor de Salvamento de Arquivos e um evento TargetFileRequested for acionado, seu aplicativo deverá criar um novo StorageFile que represente o arquivo que o usuário deseja salvar. O nome do StorageFile criado deve corresponder ao nome do arquivo especificado pela propriedade FileName . O StorageFile criado é retornado para o aplicativo que chamou o seletor de arquivos (o aplicativo de chamada) para que o aplicativo de chamada possa gravar conteúdo no arquivo. Saiba mais sobre como responder a esse evento em targetFileRequestedEventArgs.

Seu aplicativo, como o provedor de um local de salvamento, pode sinalizar que terminou sua resposta assíncrona a um evento TargetFileRequested chamando targetFileRequestDeferral.complete. Saiba mais sobre como responder de forma assíncrona a um evento TargetFileRequested em TargetFileRequestedEventArgs.

Métodos

Complete()

Sinaliza que o aplicativo que fornece o local de salvamento terminou de responder a um evento TargetFileRequested .