CachedFileUpdaterActivatedEventArgs Класс

Определение

Пространство имен:

Windows.ApplicationModel.Activation

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

Javascript Этот тип отображается как WebUICachedFileUpdaterActivatedEventArgs.

public ref class CachedFileUpdaterActivatedEventArgs sealed : IActivatedEventArgsWithUser, ICachedFileUpdaterActivatedEventArgs

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CachedFileUpdaterActivatedEventArgs final : IActivatedEventArgsWithUser, ICachedFileUpdaterActivatedEventArgs

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CachedFileUpdaterActivatedEventArgs : IActivatedEventArgsWithUser, ICachedFileUpdaterActivatedEventArgs

Public NotInheritable Class CachedFileUpdaterActivatedEventArgs
Implements IActivatedEventArgsWithUser, ICachedFileUpdaterActivatedEventArgs

Наследование

Object Platform::Object IInspectable CachedFileUpdaterActivatedEventArgs

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Реализации

IActivatedEventArgs ICachedFileUpdaterActivatedEventArgs IActivatedEventArgsWithUser

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

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
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 для переопределения OnCachedFileUpdaterActivated в объекте Application ссылается на объект CachedFileUpdaterActivatedEventArgs. Переопределение OnCachedFileUpdaterActivated находится в файле App.xaml.cs, а Activate метод — в файле CachedFileUpdaterPage.xaml.cs примера контрактов средства выбора файлов.

Комментарии

Дополнительные сведения о предоставлении обновлений для файлов, которые предлагает ваше приложение, см. в статье Краткое руководство. Предоставление файловой службы через и в справочнике по пространству имен Windows.Storage.Pickers.Provider .

Объект CachedFileUpdaterActivatedEventArgs передается обработчику активированных событий приложения, когда пользователь сохраняет файл, требующий управления содержимым из приложения. Этот тип активации обозначается значением ActivationKind.CachedFileUpdater , возвращаемым свойством Kind .

Приложения, написанные на JavaScript, должны прослушивать и обрабатывать события Windows.UI.WebUI.WebUIApplication.activated .

Приложение UWP, использующее C++, C# или Visual Basic, обычно реализует точки активации путем переопределения методов объекта Application . Файлы кода программной части app.xaml по умолчанию всегда содержат переопределение для OnLaunched, но определение переопределений для других точек активации, таких как OnCachedFileUpdaterActivated , зависит от кода приложения.

Все переопределения приложений , участвующие в сценарии активации, должны вызывать Window.Activate в своих реализациях.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1607	14393	Пользователь

Свойства

CachedFileUpdaterUI	Возвращает пользовательский интерфейс letterbox средства выбора файлов, который отображается, когда файл требует обновления из приложения.
Kind	Возвращает тип активации.
PreviousExecutionState	Возвращает состояние выполнения приложения до его активации.
SplashScreen	Возвращает объект SplashScreen , предоставляющий сведения о переходе с экрана-заставки на активированное приложение.
User	Возвращает пользователя, для которому было активировано приложение.

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

• ActivationKind
• Windows.Storage.Provider
• Activated
• OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)
• Application
• Пример контрактов средства выбора файлов