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
- Наследование
- Атрибуты
Требования к 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 . Сервер может отложить инициализацию пользовательского интерфейса до получения этого события. |