AppInstance.FindOrRegisterInstanceForKey(String) Methode

Definition

Namespace:

Windows.ApplicationModel

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

AppInstance

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.