CommandLineActivatedEventArgs Clase

Definición

Proporciona información, como los argumentos de la línea de comandos, cuando se activa una aplicación desde la línea de comandos.

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
Herencia
Object Platform::Object IInspectable CommandLineActivatedEventArgs
Atributos
Implementaciones

Requisitos de Windows

Familia de dispositivos
Windows 10 Fall Creators Update (se introdujo en la versión 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v5.0)

Ejemplos

Este es un ejemplo de control de un inicio de línea de comandos:

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

Comentarios

Una aplicación para UWP se puede activar desde Inicio|Ejecute en Windows, desde la línea de comandos de PowerShell, el símbolo del sistema de DOS o desde otro proceso de Win32 que llame a CreateProcess().

Para activarse desde la línea de comandos, la aplicación debe registrarse para la categoría de extensión "AppExecutionAlias" en su manifiesto.

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

Después de registrarse en el manifiesto, la aplicación se puede activar desde la línea de comandos. Cuando se activa la aplicación, puedes usar la información del evento para identificar la activación de la llamada y extraer los parámetros que te ayudarán a completar la llamada al usuario.

Propiedades

Kind

Obtiene el tipo de activación que inició la aplicación.

Operation

Obtiene información sobre la activación de la aplicación, como qué argumentos se proporcionaron y la ruta de acceso del directorio actual.

PreviousExecutionState

Obtiene el estado de ejecución de la aplicación antes de activarla.

SplashScreen

Obtiene información sobre la transición de la pantalla de presentación a la aplicación activada.

User

Obtiene el usuario para el que se activó la aplicación.

Se aplica a