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);

在應用程式向平臺註冊之後，當其他實例查詢應用程式實例時，就會傳回它。

應用程式實例可以使用不同的金鑰註冊多次。系統快取會針對每個實例維護一個資料列，因此會覆寫索引鍵。