SuspendingEventHandler 代理人

定義

名前空間:

Windows.UI.Xaml

Suspending イベントを処理するメソッドを表します。

public delegate void SuspendingEventHandler(Platform::Object ^ sender, SuspendingEventArgs ^ e);

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(591565925, 58218, 16610, 177, 57, 164, 112, 70, 2, 166, 225)]
class SuspendingEventHandler : MulticastDelegate

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(591565925, 58218, 16610, 177, 57, 164, 112, 70, 2, 166, 225)]
public delegate void SuspendingEventHandler(object sender, SuspendingEventArgs e);

Public Delegate Sub SuspendingEventHandler(sender As Object, e As SuspendingEventArgs)

パラメーター

sender

Object

Platform::Object

IInspectable

ハンドラーがアタッチされているオブジェクト。

e

SuspendingEventArgs

イベント データ。

属性

ContractVersionAttribute GuidAttribute

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

このコード例では、このイベントの一般的な使用パターンを示します。 このコードは、app.xaml ファイルの分離コードの一部として、 入力サンプルなど、多くの XAML サンプルで使用されます。 XAML サンプルを参照すると、このコードで参照されているクラス API の SuspensionManager ソース コードを見つけることができます。

async protected void OnSuspending(object sender, SuspendingEventArgs args)
{
    SuspendingDeferral deferral = args.SuspendingOperation.GetDeferral();
    await SuspensionManager.SaveAsync();
    deferral.Complete();
}

Private Async Sub OnSuspending(sender As Object, args As SuspendingEventArgs) 
    Dim deferral As SuspendingDeferral = args.SuspendingOperation.GetDeferral 
    Await SuspensionManager.SaveAsync 
    deferral.Complete() 
End Sub 

注釈

システムは、ユーザーが別のアプリまたはデスクトップに切り替えるたびにアプリを中断し、ユーザーがアプリに戻るたびにアプリを再開します。 ただし、リソースを解放するために、中断中にシステムでアプリを終了することもできます。 したがって、次の操作を実行するには、 Suspending イベントを処理する必要があります。

• ユーザー セッションの状態を保持します。
• リソースに対する排他ロックを解放します。
• 可能であれば、メモリ使用量を減らします。 たとえば、再アクティブ化時にオブジェクト形式で簡単に再構築できるデータをシリアル化します。
• アプリの状態を保存します。 Suspending イベントは、アプリが終了前に受信する唯一の兆候です (発生した場合)。 このため、アクティブ化中にまったく同じエクスペリエンスを再作成するのに十分なセッション状態 (現在の記事の読み取りや現在のムービーの再生位置など) を格納する必要があります。 コンテンツ作成アプリのガイダンスは、ユーザーの作業を早期かつ頻繁に保存するだけでなく、中断中に最終的な保存を 1 回コミット する方法です。 中断前にデータを保存すると便利です。 Suspending イベント ハンドラーの操作を完了するのに 5 秒しかかからないためです。

アプリが終了した場合は、 OnLaunched メソッドのオーバーライドでアプリの状態を復元できます。 アプリが終了する前にアプリが再開されると、システムはアプリの状態を自動的に復元します。 再開イベントは、ニュース フィードやユーザーの場所など、アプリの中断中に変更された可能性のある表示コンテンツを更新する必要がある場合にのみ処理する必要があります。