AppInstance.FindOrRegisterInstanceForKey(String) Méthode

Définition

Espace de noms:

Windows.ApplicationModel

Inscrit une application instance auprès de la plateforme ou recherche un instance existant si une autre instance a déjà inscrit cette clé.

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

Paramètres

key

String

Platform::String

winrt::hstring

Chaîne non vide en tant que clé pour le instance.

Retours

AppInstance

Une application instance qui représente la première application qui a inscrit la clé. L’appelant peut déterminer si cette instance est la instance actuelle.

Exemples

Cet exemple retourne le instance inscrit pour la clé spécifiée. S’il n’existait aucune instance d’application pour cette clé, la méthode inscrit le instance actuel et retourne cette instance.

theInstance = AppInstance.FindOrRegisterInstanceForKey(key);

Remarques

Une fois qu’une application s’est inscrite auprès de la plateforme, elle est retournée lorsque d’autres instances interrogent des instances d’application.

Une application instance peut s’inscrire plusieurs fois avec différentes clés. Le cache système conserve une ligne par instance, par conséquent, la clé est remplacée.