AppInstance.FindOrRegisterInstanceForKey(String) Método

Definição

Namespace:

Windows.ApplicationModel

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 ^ 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

Parâmetros

key

String

Platform::String

winrt::hstring

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

Retornos

AppInstance

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.

Exemplos

Este exemplo retorna a instância registrada para a chave especificada. Se não houver nenhuma instância de aplicativo existente para essa chave, o método registrará a instância atual e retornará essa instância.

theInstance = AppInstance.FindOrRegisterInstanceForKey(key);

Comentários

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.