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()	取得目前的 IActivatedEventArgs，這與通常會傳入應用程式的 OnActivated 方法相同。
GetInstances()	取得目前應用程式的已註冊實例。
RedirectActivationTo()	將目前應用程式實例的啟用重新導向至指定的實例。
Unregister()	更新系統快取，讓目前的實例不再可供啟用重新導向使用。

另請參閱

• 建立多執行個體通用 Windows 應用程式