C# Класс CharacterMap.Core.SuspensionManager

SuspensionManager captures global session state to simplify process lifetime management for an application. Note that session state will be automatically cleared under a variety of conditions and should only be used to store information that would be convenient to carry across sessions, but that should be discarded when an application crashes or is upgraded.
Показать файл Открыть проект

Открытые методы

Метод Описание
RegisterFrame ( Frame frame, string sessionStateKey, string sessionBaseKey = null ) : void

Registers a Frame instance to allow its navigation history to be saved to and restored from SessionState. Frames should be registered once immediately after creation if they will participate in session state management. Upon registration if state has already been restored for the specified key the navigation history will immediately be restored. Subsequent invocations of RestoreAsync will also restore navigation history.

RestoreAsync ( string sessionBaseKey = null ) : System.Threading.Tasks.Task

Restores previously saved SessionState. Any Frame instances registered with RegisterFrame will also restore their prior navigation state, which in turn gives their active Page an opportunity restore its state.

SaveAsync ( ) : System.Threading.Tasks.Task

Save the current SessionState. Any Frame instances registered with RegisterFrame will also preserve their current navigation stack, which in turn gives their active Page an opportunity to save its state.

SessionStateForFrame ( Frame frame ) : object>.Dictionary

Provides storage for session state associated with the specified Frame. Frames that have been previously registered with RegisterFrame have their session state saved and restored automatically as a part of the global SessionState. Frames that are not registered have transient state that can still be useful when restoring pages that have been discarded from the navigation cache.

Apps may choose to rely on NavigationHelper to manage page-specific state instead of working with frame session state directly.

UnregisterFrame ( Frame frame ) : void

Disassociates a Frame previously registered by RegisterFrame from SessionState. Any navigation state previously captured will be removed.

Приватные методы

Метод Описание
RestoreFrameNavigationState ( Frame frame ) : void
SaveFrameNavigationState ( Frame frame ) : void

Описание методов

RegisterFrame() публичный статический Метод

Registers a Frame instance to allow its navigation history to be saved to and restored from SessionState. Frames should be registered once immediately after creation if they will participate in session state management. Upon registration if state has already been restored for the specified key the navigation history will immediately be restored. Subsequent invocations of RestoreAsync will also restore navigation history.
public static RegisterFrame ( Frame frame, string sessionStateKey, string sessionBaseKey = null ) : void
frame Windows.UI.Xaml.Controls.Frame An instance whose navigation history should be managed by ///
sessionStateKey string A unique key into used to /// store navigation-related information.
sessionBaseKey string An optional key that identifies the type of session. /// This can be used to distinguish between multiple application launch scenarios.
Результат void

RestoreAsync() публичный статический Метод

Restores previously saved SessionState. Any Frame instances registered with RegisterFrame will also restore their prior navigation state, which in turn gives their active Page an opportunity restore its state.
public static RestoreAsync ( string sessionBaseKey = null ) : System.Threading.Tasks.Task
sessionBaseKey string An optional key that identifies the type of session. /// This can be used to distinguish between multiple application launch scenarios.
Результат System.Threading.Tasks.Task

SaveAsync() публичный статический Метод

Save the current SessionState. Any Frame instances registered with RegisterFrame will also preserve their current navigation stack, which in turn gives their active Page an opportunity to save its state.
public static SaveAsync ( ) : System.Threading.Tasks.Task
Результат System.Threading.Tasks.Task

SessionStateForFrame() публичный статический Метод

Provides storage for session state associated with the specified Frame. Frames that have been previously registered with RegisterFrame have their session state saved and restored automatically as a part of the global SessionState. Frames that are not registered have transient state that can still be useful when restoring pages that have been discarded from the navigation cache.
Apps may choose to rely on NavigationHelper to manage page-specific state instead of working with frame session state directly.
public static SessionStateForFrame ( Frame frame ) : object>.Dictionary
frame Windows.UI.Xaml.Controls.Frame The instance for which session state is desired.
Результат object>.Dictionary

UnregisterFrame() публичный статический Метод

Disassociates a Frame previously registered by RegisterFrame from SessionState. Any navigation state previously captured will be removed.
public static UnregisterFrame ( Frame frame ) : void
frame Windows.UI.Xaml.Controls.Frame An instance whose navigation history should no longer be /// managed.
Результат void