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 应用进程时，可以选择继续激活当前实例，或将激活重定向到现有实例。

shell 可以提供重定向的首选实例。 建议应用重定向到该实例。 是否重定向的选择仍由应用决定。

AppInstance 类旨在用于Main应用的 方法。 如果以后使用此类，属性值可能是 null，并且方法可能会失败。

在返回任何实例之前，必须使用 FindOrRegisterInstanceForKey 注册这些实例。

此类只能从已选择加入多实例的应用中使用。 在应用的程序包清单中的 Application 元素上指定 SupportsMultipleInstances 属性。

属性

IsCurrentInstance	应用的当前实例是否是此实例已定义的特定密钥的应用的已注册实例。
Key	当前实例的键。
RecommendedInstance	shell 可以推荐应用程序激活重定向到的应用实例。

方法

FindOrRegisterInstanceForKey(String)	向平台注册应用实例，或查找现有实例（如果另一个实例已注册此密钥）。
GetActivatedEventArgs()	获取当前 IActivatedEventArgs，通常将传递到应用的 OnActivated 方法。
GetInstances()	获取当前应用的已注册实例。
RedirectActivationTo()	将当前应用实例的激活重定向到指定的实例。
Unregister()	汇报系统缓存，以便当前实例不再可用于激活重定向。

另请参阅

• 创建多实例通用 Windows 应用