CachedFileUpdaterUI クラス

リファレンス

定義

名前空間:: Windows.Storage.Provider

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

キャッシュされたファイルアップデーターコントラクトを通じてアプリがファイルの更新を提供する場合に、ファイルピッカーと対話するために使用されます。

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

属性: 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 で導入)

例

ファイルピッカーコントラクトのサンプルでは、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 がファイルの更新を要求すると発生します。このイベントは、要求された更新ごとに 1 回発生します。

UIRequested

呼び出し元アプリが CachedFileUpdaterUI オブジェクトによって表されるファイルピッカーレターボックス UI を表示する必要がある場合に発生します。

サーバーは、このイベントを受信するまで UI の初期化を延期できます。

適用対象

こちらもご覧ください

ファイルピッカーコントラクトのサンプル

次の方法で共有