CommandLineActivatedEventArgs Класс

Определение

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

public ref class CommandLineActivatedEventArgs sealed : IActivatedEventArgsWithUser, ICommandLineActivatedEventArgs
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CommandLineActivatedEventArgs final : IActivatedEventArgsWithUser, ICommandLineActivatedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CommandLineActivatedEventArgs : IActivatedEventArgsWithUser, ICommandLineActivatedEventArgs
Public NotInheritable Class CommandLineActivatedEventArgs
Implements IActivatedEventArgsWithUser, ICommandLineActivatedEventArgs
Наследование
Object Platform::Object IInspectable CommandLineActivatedEventArgs
Атрибуты
Реализации

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

Семейство устройств
Windows 10 Fall Creators Update (появилось в 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v5.0)

Примеры

Ниже приведен пример обработки запуска из командной строки:

protected override void OnActivated(IActivatedEventArgs args)
{
    string activationArgString = string.Empty;
    string activationPath = string.Empty;
    string cmdLineString = string.Empty;

    // Existing behavior to differentiate different activation kinds,
    // and to extract any argument payload.
    switch (args.Kind)
    {
        case ActivationKind.Launch:
            var launchArgs = args as LaunchActivatedEventArgs;
            activationArgString = launchArgs.Arguments;
            break;

        // A new ActivationKind for console activation of a windowed app.
        case ActivationKind.CommandLineLaunch:
            CommandLineActivatedEventArgs cmdLineArgs = args as CommandLineActivatedEventArgs;
            CommandLineActivationOperation operation = cmdLineArgs.Operation;
            cmdLineString = operation.Arguments;
            activationPath = operation.CurrentDirectoryPath;
            break;
    }

    // Parse the trusted activation arguments.
    ParseTrustedArgs(activationArgString);

    // Parse the untrusted command-line arguments.
    ParseUntrustedArgs(activationPath, cmdLineString);

    // Since we did not take a deferral, the calling app gets the result
    // as soon as this method returns. Since we did not set an exit code,
    // the calling app gets a default exit code as the result.
}    

Комментарии

Приложение UWP можно активировать на начальном экране|Запустите в Windows из командной строки в PowerShell, командной строке DOS или из другого процесса Win32, который вызывает CreateProcess().

Для активации из командной строки приложение должно быть зарегистрировано в категории расширения AppExecutionAlias в своем манифесте.

<uap5:Extension Category="windows.appExecutionAlias" Executable="FruitSalad.exe" EntryPoint="Windows.FruitSalad.Bananas.App">
    <uap5:AppExecutionAlias >
        <uap5:ExecutionAlias Alias="Fs.exe" />
    </uap5:AppExecutionAlias>
</uap5:Extension>

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

Свойства

Kind

Возвращает тип активации, которая запустила приложение.

Operation

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

PreviousExecutionState

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

SplashScreen

Получает сведения о переходе с экрана-заставки на активированное приложение.

User

Возвращает пользователя, для которому было активировано приложение.

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