Получение сведений об активации для упакованных приложений

Начиная с Windows 10 версии 1809 упакованные классические приложения могут вызывать метод AppInstance.GetActivatedEventArgs для получения определенных типов сведений о активации приложения во время запуска. Например, вы можете вызвать этот метод, чтобы получить информацию о событиях, связанных с активацией приложения, таких как открытие файла, нажатие на интерактивное всплывающее уведомление или использование протокола. Начиная с Windows 10 версии 2004 эта функция также поддерживается в упакованных приложениях с внешним расположением (см. предоставьте идентификатор пакета, упаковав его с внешним расположением).

Пример кода

В следующем примере кода показано, как вызвать метод AppInstance.GetActivatedEventArgs из функции Main в приложении Windows Forms. Для каждого типа активации, поддерживаемого приложением, приведите возвращаемое значение args к соответствующему типу аргументов события. В этом примере кода предполагается, что методы Handlexxx представлены в виде выделенного кода обработчика активации, который был определен в другом месте.

static void Main()
{
    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);

    var args = AppInstance.GetActivatedEventArgs();
    switch (args.Kind)
    {
        case ActivationKind.Launch:
            HandleLaunch(args as LaunchActivatedEventArgs);
            break;
        case ActivationKind.ToastNotification:
            HandleToastNotification(args as ToastNotificationActivatedEventArgs);
            break;
        case ActivationKind.VoiceCommand:
            HandleVoiceCommand(args as VoiceCommandActivatedEventArgs);
            break;
        case ActivationKind.File:
            HandleFile(args as FileActivatedEventArgs);
            break;
        case ActivationKind.Protocol:
            HandleProtocol(args as ProtocolActivatedEventArgs);
            break;
        case ActivationKind.StartupTask:
            HandleStartupTask(args as StartupTaskActivatedEventArgs);
            break;
        default:
            HandleLaunch(null);
            break;
    }

Поддерживаемые типы активации

Метод AppInstance.GetActivatedEventArgs можно использовать для получения сведений об активации из поддерживаемого набора объектов аргументов событий, приведенных в таблице ниже. Для некоторых из этих типов активации требуется использовать расширение пакета в манифесте пакета.

ShareTargetActivatedEventArgs информация об активации поддерживается только в Windows 10 версии 2004 и более поздних версиях. Все остальные типы сведений о активации поддерживаются в Windows 10 версии 1809 и более поздних версий.