FileUpdateRequestDeferral 类

定义

命名空间:

Windows.Storage.Provider

使用 以异步方式完成更新。

public ref class FileUpdateRequestDeferral sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileUpdateRequestDeferral final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileUpdateRequestDeferral

Public NotInheritable Class FileUpdateRequestDeferral

继承

Object Platform::Object IInspectable FileUpdateRequestDeferral

属性

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

示例

文件选取器协定示例演示如何响应 FileUpdateRequested 事件，包括如何获取延迟。

// Event handler
void CachedFileUpdaterUI_FileUpdateRequested(CachedFileUpdaterUI sender, FileUpdateRequestedEventArgs args)
{
    fileUpdateRequest = args.Request;
    fileUpdateRequestDeferral = fileUpdateRequest.GetDeferral();
    switch (cachedFileUpdaterUI.UIStatus)
    {
        case UIStatus.Hidden:
            fileUpdateRequest.Status = FileUpdateStatus.UserInputNeeded;
            fileUpdateRequestDeferral.Complete();
            break;
        case UIStatus.Visible:
            break;
        case UIStatus.Unavailable:
            fileUpdateRequest.Status = FileUpdateStatus.Failed;
            fileUpdateRequestDeferral.Complete();
            break;
    }
}

// Register for the event
cachedFileUpdaterUI.FileUpdateRequested += CachedFileUpdaterUI_FileUpdateRequested;

args 包含 FileUpdateRequestedEventArgs 对象。

注解

如果你的应用参与缓存文件更新程序合约，并且你无法在从 FileUpdateRequested 事件处理程序返回之前完成对更新的响应，请调用 FileUpdaterRequestDeferral.Complete 方法以异步方式完成更新。

注意

文件选取器 UI 被禁用，直到应用完成对触发的所有 FileUpdateRequested 事件的响应。

若要了解如何响应 FileUpdateRequested 事件，请参阅 FileUpdateRequestedEventArgs。

方法

Complete()

指示对 FileUpdateRequested 事件的响应已完成。