AppInstance.FindOrRegisterForKey(String) Methode

Referenz

Definition

Namespace:: Microsoft.Windows.AppLifecycle

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.

Bearbeiten

Registriert eine App instance bei der Plattform oder findet eine vorhandene instance, wenn ein anderer instance diesen Schlüssel bereits registriert hat.

public:
 static AppInstance ^ FindOrRegisterForKey(Platform::String ^ key);

/// [Windows.Foundation.Metadata.Experimental]
 static AppInstance FindOrRegisterForKey(winrt::hstring const& key);

 static AppInstance FindOrRegisterForKey(winrt::hstring const& key);

[Windows.Foundation.Metadata.Experimental]
public static AppInstance FindOrRegisterForKey(string key);

public static AppInstance FindOrRegisterForKey(string key);

function findOrRegisterForKey(key)

Public Shared Function FindOrRegisterForKey (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 den aktuellen instance handelt.

Attribute: ExperimentalAttribute

Hinweise

Während die FindOrRegisterInstanceForKey-Methode im Windows-Betriebssystem spezifisch für instance Umleitung ist, ermöglicht diese Methode im Windows App SDK, dass die App einen Schlüssel aus beliebigem Grund registriert.

Nachdem eine App bei der Plattform registriert wurde, wird sie zurückgegeben, wenn andere Instanzen nach App-Instanzen abfragen.

Eine App instance kann sich mehrmals mit verschiedenen Schlüsseln registrieren. Der Systemcache verwaltet eine Zeile pro instance, daher wird der Schlüssel überschrieben.

Gilt für: