CachedFileUpdaterUI Класс

Определение

Используется для взаимодействия с элементом выбора файлов, если приложение предоставляет обновления файлов через контракт средства обновления кэшированных файлов.

public ref class CachedFileUpdaterUI sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class CachedFileUpdaterUI final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class CachedFileUpdaterUI
Public NotInheritable Class CachedFileUpdaterUI
Наследование
Object Platform::Object IInspectable CachedFileUpdaterUI
Атрибуты

Требования к 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)

Примеры

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

// CachedFileUpdater activated event handler
protected override void OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs args)
{
    var CachedFileUpdaterPage = new SDKTemplate.CachedFileUpdaterPage();
    CachedFileUpdaterPage.Activate(args);
}

// Overloaded method to respond to CachedFileUpdater events
public void Activate(CachedFileUpdaterActivatedEventArgs args)
{
            // Get file picker UI
            cachedFileUpdaterUI = args.CachedFileUpdaterUI;

            cachedFileUpdaterUI.FileUpdateRequested += CachedFileUpdaterUI_FileUpdateRequested;
            cachedFileUpdaterUI.UIRequested += CachedFileUpdaterUI_UIRequested;

            switch (cachedFileUpdaterUI.UpdateTarget)
            {
                case CachedFileTarget.Local:
                    scenarios = new List<Scenario> { new Scenario() { Title = "Get latest version", ClassType = typeof(FilePickerContracts.CachedFileUpdater_Local) } };
                    break;
                case CachedFileTarget.Remote:
                    scenarios = new List<Scenario> { new Scenario() { Title = "Remote file update", ClassType = typeof(FilePickerContracts.CachedFileUpdater_Remote) } };
                    break;
            }

            Window.Current.Activate();
        }

Для C# args содержит объект CachedFileUpdaterActivatedEventArgs . Кроме того, находится в файле App.xaml.cs, OnCachedFileUpdaterActivated а Activate метод — в файле CachedFileUpdaterPage.xaml.cs примера контрактов средства выбора файлов.

Комментарии

Получите объект CachedFileUpdaterUI с помощью свойства CachedFileUpdaterActivatedEventArgs.CachedFileUpdaterUI .

Свойства

Title

Возвращает или задает заголовок, отображаемый в левом верхнем углу пользовательского интерфейса средства выбора файлов. Заголовок определяет расположение или контекст страницы приложения (которая размещена в пользовательском интерфейсе средства выбора файлов) для пользователя.

UIStatus

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

UpdateRequest

Возвращает запрос на обновление файла, который в настоящее время обрабатывается кэшированным средством обновления файлов.

UpdateTarget

Возвращает значение, указывающее, какую версию файла необходимо обновить: локальную версию или версию в репозитории приложения.

Методы

GetDeferral()

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

События

FileUpdateRequested

Срабатывает, когда Windows запрашивает обновление файла. Это событие срабатывает один раз для каждого запрошенного обновления.

UIRequested

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

Сервер может отложить инициализацию пользовательского интерфейса до получения этого события.

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

См. также раздел