AppInstance.FindOrRegisterInstanceForKey(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Registriert eine App instance bei der Plattform oder sucht nach einem vorhandenen instance, wenn dieser Schlüssel bereits von einem anderen instance registriert wurde.
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
Parameter
- key
-
String
Platform::String
winrt::hstring
Eine nicht leere Zeichenfolge als Schlüssel für die instance.
Gibt zurück
Eine App instance, die die erste App darstellt, die den Schlüssel registriert hat. Der Aufrufer kann bestimmen, ob es sich bei diesem instance um die aktuelle instance handelt.
Beispiele
In diesem Beispiel wird die für den angegebenen Schlüssel registrierte instance zurückgegeben. Wenn für diesen Schlüssel keine App-instance vorhanden ist, registriert die Methode den aktuellen instance und gibt diesen instance zurück.
theInstance = AppInstance.FindOrRegisterInstanceForKey(key);
Hinweise
Nachdem eine App bei der Plattform registriert wurde, wird sie zurückgegeben, wenn andere Instanzen App-Instanzen abfragen.
Eine App instance kann mehrere Male mit verschiedenen Schlüsseln registriert werden. Der Systemcache verwaltet eine Zeile pro instance daher wird der Schlüssel überschrieben.