CommandLineActivatedEventArgs Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.Activation

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

ContractVersionAttribute MarshalingBehaviorAttribute

Implementaciones

IActivatedEventArgs IActivatedEventArgsWithUser ICommandLineActivatedEventArgs

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.