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 事件的回應已完成。