AppInstance.FindOrRegisterInstanceForKey(String) Método

Definición

Espacio de nombres:

Windows.ApplicationModel

Registra una instancia de aplicación con la plataforma o busca una instancia existente si otra instancia ya ha registrado esta clave.

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

Cadena no vacía como clave para la instancia de .

Devoluciones

AppInstance

Instancia de aplicación que representa la primera aplicación que registró la clave. El autor de la llamada puede determinar si esa instancia es la instancia actual.

Ejemplos

En este ejemplo se devuelve la instancia registrada para la clave especificada. Si no había ninguna instancia de aplicación existente para esa clave, el método registra la instancia actual y devuelve esa instancia.

theInstance = AppInstance.FindOrRegisterInstanceForKey(key);

Comentarios

Después de que una aplicación se haya registrado con la plataforma, se devuelve cuando otras instancias consultan las instancias de la aplicación.

Una instancia de aplicación puede registrarse varias veces con claves diferentes. La memoria caché del sistema mantiene una fila por instancia, por lo que la clave se sobrescribe.