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 对象。 此外, 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 初始化,直到收到此事件。

适用于

另请参阅