AppInstance.FindOrRegisterForKey(String) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編輯

向平臺註冊應用程式實例，或在另一個實例已註冊此金鑰時尋找現有的實例。

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

非空白字串做為實例的索引鍵。

應用程式實例，表示註冊金鑰的第一個應用程式。呼叫端可以判斷該實例是否為目前的實例。

雖然 Windows OS 中的FindOrRegisterInstanceForKey方法專屬於實例重新導向，但Windows 應用程式 SDK允許應用程式基於任何原因註冊金鑰。

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

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