AppInstance.FindOrRegisterInstanceForKey(String) 方法

定义

向平台注册应用实例,或查找现有实例(如果另一个实例已注册此密钥)。

public:
 static AppInstance ^ FindOrRegisterInstanceForKey(Platform::String ^ key);
 static AppInstance FindOrRegisterInstanceForKey(winrt::hstring const& key);
public static AppInstance FindOrRegisterInstanceForKey(string key);
function findOrRegisterInstanceForKey(key)
Public Shared Function FindOrRegisterInstanceForKey (key As String) As AppInstance

参数

key
String

Platform::String

winrt::hstring

作为实例键的非空字符串。

返回

表示注册密钥的第一个应用的应用实例。 调用方可以确定该实例是否为当前实例。

示例

此示例返回为指定键注册的 实例。 如果不存在该密钥的现有应用实例,该方法将注册当前实例,并返回该实例。

theInstance = AppInstance.FindOrRegisterInstanceForKey(key);

注解

在向平台注册应用后,当其他实例查询应用实例时,将返回该应用。

应用实例可以使用不同的密钥多次注册。 系统缓存为每个实例保留一行,因此会覆盖密钥。

适用于