CommandLineActivatedEventArgs Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Activation

Fornisce informazioni, ad esempio gli argomenti della riga di comando, quando un'app viene attivata dalla riga di 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

Ereditarietà

Object Platform::Object IInspectable CommandLineActivatedEventArgs

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni

IActivatedEventArgs IActivatedEventArgsWithUser ICommandLineActivatedEventArgs

Requisiti Windows

Famiglia di dispositivi	Windows 10 Fall Creators Update (è stato introdotto in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v5.0)

Esempio

Di seguito è riportato un esempio di gestione dell'avvio da riga di 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.
}    

Commenti

Un'app UWP può essere attivata da Start|Eseguire in Windows, dalla riga di comando in PowerShell, dal prompt dei comandi DOS o da un altro processo Win32 che chiama CreateProcess().Run in Windows, from the command line in PowerShell, the DOS command prompt, or from another Win32 process that calls CreateProcess().

Per essere attivato dalla riga di comando, l'app deve registrarsi per la categoria di estensione "AppExecutionAlias" nel 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>

Dopo la registrazione nel manifesto, l'app può essere attivata dalla riga di comando. Quando l'app viene attivata, è possibile usare le informazioni sull'evento per identificare l'attivazione della chiamata ed estrarre i parametri che consentono di completare la chiamata per l'utente.

Proprietà

Kind	Ottiene il tipo di attivazione che ha avviato l'app.
Operation	Ottiene informazioni sull'attivazione dell'app, ad esempio gli argomenti forniti e il percorso della directory corrente.
PreviousExecutionState	Ottiene lo stato di esecuzione dell'app prima dell'attivazione.
SplashScreen	Ottiene informazioni sulla transizione dalla schermata iniziale all'app attivata.
User	Ottiene l'utente per cui è stata attivata l'app.