次の方法で共有


AppInstance.FindOrRegisterInstanceForKey(String) メソッド

定義

アプリ インスタンスをプラットフォームに登録するか、別のインスタンスがこのキーを既に登録している場合は既存のインスタンスを検索します。

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

パラメーター

key
String

Platform::String

winrt::hstring

インスタンスのキーとしての空でない文字列。

戻り値

キーを登録した最初のアプリを表すアプリ インスタンス。 呼び出し元は、そのインスタンスが現在のインスタンスであるかどうかを判断できます。

次の使用例は、指定したキーに登録されているインスタンスを返します。 そのキーの既存のアプリ インスタンスがない場合、メソッドは現在のインスタンスを登録し、そのインスタンスを返します。

theInstance = AppInstance.FindOrRegisterInstanceForKey(key);

注釈

アプリがプラットフォームに登録されると、他のインスタンスがアプリ インスタンスに対してクエリを実行すると、アプリが返されます。

アプリ インスタンスは、異なるキーで複数回登録できます。 システム キャッシュはインスタンスごとに 1 行を保持するため、キーは上書きされます。

適用対象