TargetFileRequest Класс

Ссылка

Определение

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

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Изменить

Позволяет приложению, предоставляющей расположение для сохранения, указать StorageFile , представляющий файл для сохранения, и получить отсрочку, чтобы приложение может асинхронно реагировать на событие 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

Наследование: Object Platform::Object IInspectable TargetFileRequest

Атрибуты: 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, в том числе как использовать свойство Request для получения 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);

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

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

Свойства

TargetFile

Возвращает или задает объект IStorageFile , предоставляемый для представления файла, сохраняемого приложением, предоставляющим расположение сохранения.

Методы

GetDeferral()

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

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

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