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#， args 針對Application物件上的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	User

屬性

CachedFileUpdaterUI	取得檔案需要應用程式更新時所顯示之檔案選擇器的信件箱 UI。
Kind	取得啟用類型。
PreviousExecutionState	取得應用程式啟動前的執行狀態。
SplashScreen	取得 SplashScreen 物件，提供從啟動顯示畫面轉換到啟動的應用程式的相關資訊。
User	取得應用程式已啟用的使用者。

另請參閱

• ActivationKind
• Windows.Storage.Provider
• Activated
• OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)
• Application
• 檔案選擇器合約範例