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对于 Application 对象上的OnCachedFileUpdaterActivated 替代，引用 CachedFileUpdaterActivatedEventArgs 对象。 OnCachedFileUpdaterActivated 重写位于 App.xaml.cs 文件中，Activate方法位于文件选取器协定示例的 CachedFileUpdaterPage.xaml.cs 文件中。

注解

若要详细了解如何为应用提供的文件提供更新 ，请参阅快速入门：通过 和 Windows.Storage.Pickers.Provider 命名空间参考提供文件服务。

当用户保存需要从应用进行内容管理的文件时，CachedFileUpdaterActivatedEventArgs 对象将传递到应用的激活事件处理程序。 此类激活由 Kind 属性返回的 ActivationKind.CachedFileUpdater 值指示。

用 JavaScript 编写的应用必须侦听并处理 Windows.UI.WebUI.WebUIApplication.activated 事件。

使用 C++、C# 或 Visual Basic 的 UWP 应用通常通过重写 Application 对象的方法来实现激活点。 默认模板 app.xaml 代码隐藏文件始终包含 OnLaunched 的替代，但为其他激活点（如 OnCachedFileUpdaterActivated ）定义替代取决于应用代码。

激活方案涉及的所有 应用程序 替代都应在其实现中调用 Window.Activate 。

版本历史记录

Windows 版本	SDK 版本	已添加值
1607	14393	User

属性

CachedFileUpdaterUI	获取文件选取器在需要应用更新时显示的信箱 UI。
Kind	获取激活类型。
PreviousExecutionState	获取应用在激活前的执行状态。
SplashScreen	获取 SplashScreen 对象，该对象提供有关从初始屏幕到激活的应用的转换的信息。
User	获取为其激活应用的用户。

另请参阅

• ActivationKind
• Windows.Storage.Provider
• Activated
• OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)
• Application
• 文件选取器协定示例