AppInstance クラス

リファレンス

定義

名前空間:: Windows.ApplicationModel

重要

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

編集

アプリのインスタンスを表します。

public ref class AppInstance sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppInstance final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppInstance

Public NotInheritable Class AppInstance

継承: Object Platform::Object IInspectable AppInstance

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイスファミリ	Windows 10, version 1803 (10.0.17134.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v6.0 で導入)

注釈

システムは、アプリインスタンスのストアを保持します。アプリは、アクティブ化を試みたときにアプリのリダイレクトにこれを使用できます。

アプリプロセスがアプリのメソッドで Main 作成されると、現在のインスタンスのアクティブ化を続行するか、アクティブ化を既存のインスタンスにリダイレクトすることを選択できます。

シェルは、リダイレクトに推奨されるインスタンスを提供できます。アプリは、そのインスタンスにリダイレクトすることをお勧めします。リダイレクトするかどうかの選択は、アプリに残ります。

AppInstance クラスは、アプリのメソッドでMain使用することを目的としています。このクラスを後で使用する場合、プロパティ値はである null可能性があり、メソッドは失敗する可能性があります。

インスタンスを返すには、その前に FindOrRegisterInstanceForKey に登録する必要があります。

このクラスは、複数インスタンス化にオプトインしたアプリからのみ使用できます。アプリのパッケージマニフェストの Application 要素に SupportsMultipleInstances 属性を指定します。

プロパティ

IsCurrentInstance	アプリの現在のインスタンスが、このインスタンスが定義した特定のキーのアプリの登録済みインスタンスであるかどうか。
Key	現在のインスタンスのキー。
RecommendedInstance	シェルは、アプリケーションのアクティブ化がリダイレクトされるアプリのインスタンスを推奨できます。

メソッド

FindOrRegisterInstanceForKey(String)	アプリインスタンスをプラットフォームに登録するか、別のインスタンスがこのキーを既に登録している場合は既存のインスタンスを検索します。
GetActivatedEventArgs()	アプリの OnActivated メソッドに通常渡されるのと同じ、現在の IActivatedEventArgs を取得します。
GetInstances()	現在のアプリの登録済みインスタンスを取得します。
RedirectActivationTo()	現在のアプリインスタンスのアクティブ化を、指定したインスタンスにリダイレクトします。
Unregister()	現在のインスタンスをアクティブ化リダイレクトで使用できないように、システムキャッシュを更新します。

適用対象

こちらもご覧ください

マルチインスタンスのユニバーサル Windows アプリの作成