AppInstance.FindOrRegisterForKey(String) メソッド

定義

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

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

パラメーター

key
String

Platform::String

winrt::hstring

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

戻り値

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

属性

注釈

Windows OS の FindOrRegisterInstanceForKey メソッドはインスタンス リダイレクトに固有ですが、Windows アプリ SDKのこのメソッドを使用すると、アプリで何らかの理由でキーを登録できます。

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

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

適用対象

こちらもご覧ください