CommandLineActivatedEventArgs Klasse

Referenz

Definition

Namespace:: Windows.ApplicationModel.Activation

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt Informationen bereit, z. B. die Befehlszeilenargumente, wenn eine App über die Befehlszeile aktiviert wird.

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

Vererbung: Object Platform::Object IInspectable CommandLineActivatedEventArgs

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert: IActivatedEventArgs IActivatedEventArgsWithUser ICommandLineActivatedEventArgs

Windows-Anforderungen

Gerätefamilie	Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v5.0)

Beispiele

Hier sehen Sie ein Beispiel für die Behandlung eines Befehlszeilenstarts:

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

Hinweise

Eine UWP-App kann über Start|Führen Sie in Windows, über die Befehlszeile in PowerShell, die DOS-Eingabeaufforderung oder über einen anderen Win32-Prozess aus, der CreateProcess()aufruft.

Um über die Befehlszeile aktiviert zu werden, muss sich Ihre App für die Erweiterungskategorie "AppExecutionAlias" in ihrem Manifest registrieren.

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

Nachdem Sie sich in Ihrem Manifest registriert haben, kann Ihre App über die Befehlszeile aktiviert werden. Wenn Ihre App aktiviert ist, können Sie die Ereignisinformationen verwenden, um die Anrufaktivierung zu identifizieren und die Parameter zu extrahieren, die Ihnen beim Abschließen des Anrufs für den Benutzer helfen.

Eigenschaften

Kind	Ruft den Aktivierungstyp ab, durch den die App gestartet wurde.
Operation	Ruft Informationen zur Aktivierung der App ab, z. B. die bereitgestellten Argumente und den aktuellen Verzeichnispfad.
PreviousExecutionState	Ruft den Ausführungsstatus der App ab, bevor sie aktiviert wurde.
SplashScreen	Ruft Informationen zum Übergang vom Begrüßungsbildschirm zur aktivierten App ab.
User	Ruft den Benutzer ab, für den die App aktiviert wurde.

Gilt für:

Freigeben über