AppInstance.FindOrRegisterInstanceForKey(String) メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

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

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

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

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

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

theInstance = AppInstance.FindOrRegisterInstanceForKey(key);

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

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