AppInstance 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，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 AppInstancePublic NotInheritable Class AppInstance- 继承
- 属性
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() |
汇报系统缓存，以便当前实例不再可用于激活重定向。 |