Поделиться через


AppInstance Класс

Определение

Представляет экземпляр приложения.

public ref class AppInstance sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppInstance final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppInstance
Public NotInheritable Class AppInstance
Наследование
Object Platform::Object IInspectable AppInstance
Атрибуты

Требования к Windows

Семейство устройств
Windows 10, version 1803 (появилось в 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v6.0)

Комментарии

Система поддерживает хранилище экземпляров приложений. Приложения могут использовать его для перенаправления приложения при попытке активации.

При создании процесса приложения в методе Main приложения он может продолжить активацию текущего экземпляра или перенаправить активацию на существующий экземпляр.

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

Класс AppInstance предназначен для использования в методе Main приложения. Если этот класс используется позже, значения свойств могут иметь значение , а методы могут завершиться nullошибкой.

Перед возвратом каких-либо экземпляров их необходимо зарегистрировать с помощью FindOrRegisterInstanceForKey.

Этот класс можно использовать только из приложения, которое согласилось на использование нескольких экземпляров. Укажите атрибут SupportsMultipleInstances в элементе Application в манифесте пакета для приложения.

Свойства

IsCurrentInstance

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

Key

Ключ для текущего экземпляра.

RecommendedInstance

Оболочка может рекомендовать экземпляр приложения, на который перенаправляется активация приложения.

Методы

FindOrRegisterInstanceForKey(String)

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

GetActivatedEventArgs()

Возвращает текущий объект IActivatedEventArgs, который обычно передается методу OnActivated приложения.

GetInstances()

Возвращает зарегистрированные экземпляры текущего приложения.

RedirectActivationTo()

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

Unregister()

Обновления системный кэш, чтобы текущий экземпляр больше не был доступен для перенаправления активации.

Применяется к

См. также раздел