Поделиться через

TargetFileRequestDeferral Класс

  • Ссылка

Определение

Пространство имен:
Windows.Storage.Pickers.Provider
Изменить

Используется приложением, предоставляющим расположение для сохранения, чтобы асинхронно указать, что приложение завершило реагирование на событие 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
Наследование
Object Platform::Object IInspectable TargetFileRequestDeferral
Атрибуты
ContractVersionAttribute

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В примере средства выбора файлов показано, как реагировать на обработчик событий TargetFileRequested, в том числе как получить отсрочку.

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

В примере e содержит объект TargetFileRequestedEventArgs .

Комментарии

Если приложение участвует в контракте средства выбора сохранения файлов и возникает событие TargetFileRequested , приложение должно создать новый файл StorageFile , представляющий файл, который пользователь хочет сохранить. Имя создаваемого файла StorageFile должно совпадать с именем файла, заданного свойством FileName . Создаваемый файл StorageFile возвращается в приложение, которое вызывало средство выбора файлов (вызывающее приложение), чтобы вызывающее приложение яировало к файлу. Дополнительные сведения о реагировании на это событие см. в разделе targetFileRequestedEventArgs.

Ваше приложение, как поставщик расположения сохранения, может сообщить о завершении асинхронного ответа на событие TargetFileRequested , вызвав targetFileRequestDeferral.complete. Дополнительные сведения об асинхронном реагировании на событие TargetFileRequested см. в статье TargetFileRequestedEventArgs.

Методы

Complete()

Сигнализирует о том, что приложение, предоставляющее расположение сохранения, завершило реагирование на событие TargetFileRequested .

Применяется к