Compartilhar via


AppInstance.FindOrRegisterForKey(String) Método

Definição

Registra uma instância de aplicativo com a plataforma ou localiza uma instância existente se outra instância já tiver registrado essa chave.

public:
 static AppInstance ^ FindOrRegisterForKey(Platform::String ^ key);
/// [Windows.Foundation.Metadata.Experimental]
 static AppInstance FindOrRegisterForKey(winrt::hstring const& key);
 static AppInstance FindOrRegisterForKey(winrt::hstring const& key);
[Windows.Foundation.Metadata.Experimental]
public static AppInstance FindOrRegisterForKey(string key);
public static AppInstance FindOrRegisterForKey(string key);
function findOrRegisterForKey(key)
Public Shared Function FindOrRegisterForKey (key As String) As AppInstance

Parâmetros

key
String

Platform::String

winrt::hstring

Uma cadeia de caracteres não vazia como uma chave para a instância.

Retornos

Uma instância de aplicativo que representa o primeiro aplicativo que registrou a chave. O chamador pode determinar se essa instância é a instância atual.

Atributos

Comentários

Enquanto o método FindOrRegisterInstanceForKey no sistema operacional Windows é específico para redirecionamento de instância, esse método no SDK do Aplicativo Windows permite que o aplicativo registre uma chave por qualquer motivo.

Depois que um aplicativo é registrado com a plataforma, ele é retornado quando outras instâncias consultam instâncias de aplicativo.

Uma instância de aplicativo pode se registrar várias vezes com chaves diferentes. O cache do sistema mantém uma linha por instância, portanto, a chave é substituída.

Aplica-se a

Confira também