CachedFileUpdaterActivatedEventArgs クラス

定義

名前空間:

Windows.ApplicationModel.Activation

ユーザーがアプリからの更新を必要とするファイルを保存または開いたときに発生するアクティブ化されたイベントに関する情報を提供します。

Javascript この種類は 、WebUICachedFileUpdaterActivatedEventArgs として表示されます。

public ref class CachedFileUpdaterActivatedEventArgs sealed : IActivatedEventArgsWithUser, ICachedFileUpdaterActivatedEventArgs

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CachedFileUpdaterActivatedEventArgs final : IActivatedEventArgsWithUser, ICachedFileUpdaterActivatedEventArgs

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CachedFileUpdaterActivatedEventArgs : IActivatedEventArgsWithUser, ICachedFileUpdaterActivatedEventArgs

Public NotInheritable Class CachedFileUpdaterActivatedEventArgs
Implements IActivatedEventArgsWithUser, ICachedFileUpdaterActivatedEventArgs

継承

Object Platform::Object IInspectable CachedFileUpdaterActivatedEventArgs

属性

ContractVersionAttribute MarshalingBehaviorAttribute

実装

IActivatedEventArgs ICachedFileUpdaterActivatedEventArgs IActivatedEventArgsWithUser

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
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# の場合、 argsApplication オブジェクトの OnCachedFileUpdaterActivated オーバーライドでは、CachedFileUpdaterActivatedEventArgs オブジェクトが参照されます。 OnCachedFileUpdaterActivated オーバーライドは App.xaml.cs ファイルにあり、Activateメソッドはファイル ピッカー コントラクト サンプルの CachedFileUpdaterPage.xaml.cs ファイルにあります。

注釈

アプリが提供するファイルの更新プログラムの提供の詳細については、「クイック スタート: Windows.Storage.Pickers.Provider 名前空間を使用したファイル サービスの提供」を参照してください。

CachedFileUpdaterActivatedEventArgs オブジェクトは、ユーザーがアプリのコンテンツ管理を必要とするファイルを保存するときに、アプリのアクティブ化されたイベント ハンドラーに渡されます。 この種類のアクティブ化は、Kind プロパティによって返される ActivationKind.CachedFileUpdater 値によって示されます。

JavaScript で記述されたアプリは、 Windows.UI.WebUI.WebUIApplication.activated イベントをリッスンして処理する必要があります。

C++、C#、または Visual Basic を使用する UWP アプリでは、通常 、Application オブジェクトのメソッドをオーバーライドしてアクティブ化ポイントを実装します。 既定のテンプレート app.xaml 分離コード ファイルには常に OnLaunched のオーバーライドが含まれますが、 OnCachedFileUpdaterActivated などの他のアクティブ化ポイントのオーバーライドの定義は、アプリ コードに依存します。

アクティブ化シナリオに関連するすべての アプリケーション オーバーライドは、実装で Window.Activate を呼び出す必要があります。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1607	14393	ユーザー

プロパティ

CachedFileUpdaterUI	アプリからファイルを更新する必要がある場合に表示されるファイル ピッカーのレターボックス UI を取得します。
Kind	アクティブ化の種類を取得します。
PreviousExecutionState	アクティブ化される前のアプリの実行状態を取得します。
SplashScreen	スプラッシュ スクリーンからアクティブ化されたアプリへの切り替えに関する情報を提供する SplashScreen オブジェクトを取得します。
User	アプリがアクティブ化されたユーザーを取得します。

こちらもご覧ください

• ActivationKind
• Windows.Storage.Provider
• Activated
• OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)
• Application
• ファイル ピッカー コントラクトのサンプル