AppInstance クラス

  • リファレンス

定義

名前空間:
Windows.ApplicationModel
編集

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

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()

現在のインスタンスをアクティブ化リダイレクトで使用できないように、システム キャッシュを更新します。

適用対象

こちらもご覧ください