CachedFileUpdaterUI.FileUpdateRequested イベント

定義

名前空間:

Windows.Storage.Provider

Windows がファイルの更新を要求すると発生します。 このイベントは、要求された更新ごとに 1 回発生します。

// 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 オブジェクトが 含まれています。

注釈

アプリが Cached File Updater コントラクトに参加している場合は、ActivationKind.CachedFileUpdater をチェックするアプリのアクティブ化イベント ハンドラーで、このイベントに登録する必要があります。 この FileUpdateRequested イベントに応答するには、ファイルを更新し、要求の FileUpdateRequest.Status を 設定する必要があります。 CachedFileUpdaterUI を使用します。UpdateTarget プロパティを使用して、アプリがリポジトリ内のバージョン ファイルを更新するか、要求に応答してローカルにキャッシュされたファイルのコピーを更新するかを決定します。

FileUpdateRequested イベント ハンドラーに渡されるオブジェクトの FileUpdateRequestedEventArgs.Request プロパティを使用すると、要求された更新に関する情報にアクセスできます。 

更新を完了するためにユーザー入力が必要な場合は、 FileUpdateRequest.Status を FileUpdateStatus.UserInputNeeded に 設定し、要求を完了します。 ユーザー操作が使用可能な場合は、別の FileUpdateRequested が起動し、アプリでユーザー入力を取得し、要求を完了できます。