CachedFileUpdaterUI 类

定义

命名空间:

Windows.Storage.Provider

如果你的应用通过缓存文件更新程序合约提供文件更新，则用于与文件选取器交互。

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

属性

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 中引入)

示例

文件选取器协定示例演示如何响应 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 对象。 此外， OnCachedFileUpdaterActivated 位于 App.xaml.cs 文件中， Activate 方法位于 文件选取器协定示例的 CachedFileUpdaterPage.xaml.cs 文件中。

注解

使用 CachedFileUpdaterActivatedEventArgs.CachedFileUpdaterUI 属性检索 CachedFileUpdaterUI 对象。

属性

Title	获取或设置要显示在文件选取器 UI 左上角的标题。 游戏标识应用页面的位置或上下文 (，该页面托管在用户的文件选取器 UI) 中。
UIStatus	获取一个枚举值，该值指示文件选取器 UI 的状态。
UpdateRequest	获取缓存文件更新程序当前正在处理的文件更新请求。
UpdateTarget	获取一个值，该值指示需要更新文件的哪个版本：本地版本或应用存储库中的版本。

方法

GetDeferral()

获取用于异步完成文件更新请求的 对象。

事件

FileUpdateRequested	当 Windows 请求文件更新时触发。 此事件针对每个请求的更新触发一次。
UIRequested	当调用应用需要显示 由 CachedFileUpdaterUI 对象表示的文件选取器信箱 UI 时触发。 服务器可能会延迟其 UI 初始化，直到收到此事件。

另请参阅

• 文件选取器协定示例