CommandLineActivatedEventArgs Classe

Definição

Namespace:

Windows.ApplicationModel.Activation

Fornece informações, como os argumentos de linha de comando, quando um aplicativo é ativado da linha de comando.

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

Herança

Object Platform::Object IInspectable CommandLineActivatedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IActivatedEventArgs IActivatedEventArgsWithUser ICommandLineActivatedEventArgs

Requisitos do Windows

Família de dispositivos	Windows 10 Fall Creators Update (introduzida na 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v5.0)

Exemplos

Aqui está um exemplo de manipulação de uma inicialização de linha de comando:

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.
}    

Comentários

Um aplicativo UWP pode ser ativado a partir de Iniciar|Execute no Windows, na linha de comando no PowerShell, no prompt de comando dos DOS ou em outro processo win32 que chama CreateProcess().

Para ser ativado a partir da linha de comando, seu aplicativo deve se registrar para a categoria de extensão "AppExecutionAlias" em seu manifesto.

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

Depois que você se registrar no manifesto, seu aplicativo poderá ser ativado na linha de comando. Quando seu aplicativo é ativado, você pode usar as informações de evento para identificar a ativação da chamada e extrair os parâmetros que ajudam você a concluir a chamada para o usuário.

Propriedades

Kind	Obtém o tipo de ativação que iniciou o aplicativo.
Operation	Obtém informações sobre a ativação do aplicativo, como quais argumentos foram fornecidos e o caminho do diretório atual.
PreviousExecutionState	Obtém o estado de execução do aplicativo antes de ser ativado.
SplashScreen	Obtém informações sobre a transição da tela inicial para o aplicativo ativado.
User	Obtém o usuário para o qual o aplicativo foi ativado.