Partilhar via


CommandLineActivatedEventArgs Classe

Definição

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
Implementações

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.

Aplica-se a