AppInstance.FindOrRegisterInstanceForKey(String) Метод

Определение

Пространство имен:

Windows.ApplicationModel

Регистрирует экземпляр приложения на платформе или находит существующий экземпляр, если другой экземпляр уже зарегистрировал этот ключ.

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

Непустая строка в качестве ключа для экземпляра.

Возвращаемое значение

AppInstance

Экземпляр приложения, представляющий первое приложение, которое зарегистрировал ключ. Вызывающий объект может определить, является ли этот экземпляр текущим.

Примеры

В этом примере возвращается экземпляр, зарегистрированный для указанного ключа. Если для этого ключа не существует экземпляра приложения, метод регистрирует текущий экземпляр и возвращает этот экземпляр.

theInstance = AppInstance.FindOrRegisterInstanceForKey(key);

Комментарии

После регистрации приложения на платформе оно возвращается, когда другие экземпляры запрашивают экземпляры приложения.

Экземпляр приложения можно зарегистрировать несколько раз с разными ключами. Системный кэш поддерживает одну строку на экземпляр, поэтому ключ перезаписывается.