CachedFileUpdaterUI.FileUpdateRequested 事件

定義

命名空間:

Windows.Storage.Provider

當 Windows 要求檔案更新時引發。 此事件會針對每個要求的更新引發一次。

// Register
event_token FileUpdateRequested(TypedEventHandler<CachedFileUpdaterUI, FileUpdateRequestedEventArgs const&> const& handler) const;

// Revoke with event_token
void FileUpdateRequested(event_token const* cookie) const;

// Revoke with event_revoker
CachedFileUpdaterUI::FileUpdateRequested_revoker FileUpdateRequested(auto_revoke_t, TypedEventHandler<CachedFileUpdaterUI, FileUpdateRequestedEventArgs const&> const& handler) const;

public event TypedEventHandler<CachedFileUpdaterUI,FileUpdateRequestedEventArgs> FileUpdateRequested;

function onFileUpdateRequested(eventArgs) { /* Your code */ }
cachedFileUpdaterUI.addEventListener("fileupdaterequested", onFileUpdateRequested);
cachedFileUpdaterUI.removeEventListener("fileupdaterequested", onFileUpdateRequested);
- or -
cachedFileUpdaterUI.onfileupdaterequested = onFileUpdateRequested;

Public Custom Event FileUpdateRequested As TypedEventHandler(Of CachedFileUpdaterUI, FileUpdateRequestedEventArgs) 

事件類型

TypedEventHandler<CachedFileUpdaterUI,FileUpdateRequestedEventArgs>

範例

檔案選擇器合約範例示範如何回應 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 物件。

備註

如果您的應用程式參與快取檔案更新程式合約，您必須在您檢查 ActivationKind.CachedFileUpdater的應用程式啟動事件處理常式中註冊此事件。 您必須更新檔案並設定要求的 FileUpdateRequest.Status，以回應此 FileUpdateRequested 事件。 使用 CachedFileUpdaterUI。UpdateTarget 屬性可判斷您的應用程式是否應該在其存放庫中更新版本檔案，或檔案的本機快取複本，以回應要求。

您可以在傳遞給 FileUpdateRequested 事件處理常式的物件上使用 FileUpdateRequestedEventArgs.Request 屬性來存取所要求更新的相關資訊。 

如果您需要使用者輸入來完成更新，請將 FileUpdateRequest.Status 設定為 FileUpdateStatus.UserInputNeeded 並完成要求。 如果有可用的使用者互動，將會引發另一個 FileUpdateRequested，而您的應用程式可以取得使用者輸入並完成要求。