AppInstance.FindOrRegisterInstanceForKey(String) Metodo

Definizione

Spazio dei nomi:

Windows.ApplicationModel

Registra un'istanza dell'app con la piattaforma oppure trova un'istanza esistente se un'altra istanza ha già registrato questa chiave.

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

Parametri

key

String

Platform::String

winrt::hstring

Stringa non vuota come chiave per l'istanza di .

Restituisce

AppInstance

Istanza dell'app che rappresenta la prima app che ha registrato la chiave. Il chiamante può determinare se tale istanza è l'istanza corrente.

Esempio

In questo esempio viene restituita l'istanza registrata per la chiave specificata. Se non esiste un'istanza dell'app esistente per tale chiave, il metodo registra l'istanza corrente e restituisce tale istanza.

theInstance = AppInstance.FindOrRegisterInstanceForKey(key);

Commenti

Dopo che un'app è stata registrata con la piattaforma, viene restituita quando altre istanze eseguono query per le istanze dell'app.

Un'istanza dell'app può registrare più volte con chiavi diverse. La cache di sistema mantiene una riga per istanza, pertanto la chiave viene sovrascritta.