FileUpdateRequest Класс

Ссылка

Определение

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

Важно!

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

Изменить

Предоставляет сведения о запрашиваемом обновлении файла, чтобы приложение е 10-1000 2000 г.

public ref class FileUpdateRequest sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileUpdateRequest final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileUpdateRequest

Public NotInheritable Class FileUpdateRequest

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

Атрибуты: 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)

Примеры

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

// Event handler
void CachedFileUpdaterUI_FileUpdateRequested(CachedFileUpdaterUI sender, FileUpdateRequestedEventArgs args)
{
    fileUpdateRequest = args.Request;
    fileUpdateRequestDeferral = fileUpdateRequest.GetDeferral();
    switch (cachedFileUpdaterUI.UIStatus)
    {
        case UIStatus.Hidden:
            fileUpdateRequest.Status = FileUpdateStatus.UserInputNeeded;
            fileUpdateRequestDeferral.Complete();
            break;
        case UIStatus.Visible:
            break;
        case UIStatus.Unavailable:
            fileUpdateRequest.Status = FileUpdateStatus.Failed;
            fileUpdateRequestDeferral.Complete();
            break;
    }
}

// Register for the event
cachedFileUpdaterUI.FileUpdateRequested += CachedFileUpdaterUI_FileUpdateRequested;

args содержит объект FileUpdateRequestedEventArgs .

Если приложение участвует в контракте средства обновления кэшированных файлов, используйте этот класс, чтобы реагировать на события FileUpdateRequested , чтобы запросить обновление файла. Доступ к этому классу можно получить из обработчика событий с помощью FileUpdateRequestedEventArgs. Свойство Request . В рамках ответа на событие FileUpdateRequested необходимо задать свойство Status этого класса, чтобы указать состояние обновления.

Дополнительные сведения о реагировании на запросы на обновление см. в разделе FileUpdateRequested и FileUpdateRequestedEventArgs.

Если приложению не удается завершить обновление перед возвратом из обработчика событий FileUpdateRequested , можно использовать свойство GetDeferral для асинхронного завершения обновления.

Свойства

ContentId	Возвращает уникальный идентификатор, используемый для связывания локальной версии файла с соответствующей удаленной версией.
File	Возвращает объект StorageFile , представляющий локально кэшированную копию обновляемого файла.
Status	Возвращает или задает состояние обновления. Это свойство задается в ответ на событие FileUpdateRequested .
UserInputNeededMessage	Возвращает или задает пользователю сообщение, указывающее, что для завершения fileUpdateRequest требуются вводимые пользователем данные.

Методы

GetDeferral()	Возвращает объект , используемый для асинхронного завершения обновления.
UpdateLocalFile(IStorageFile)	Укажите новую версию локального файла для представления удаленного файла.

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

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