CommandLineActivatedEventArgs Classe

Definizione

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
Implementazioni

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.

Si applica a