CommandLineActivatedEventArgs 클래스

정의

네임스페이스:

Windows.ApplicationModel.Activation

명령줄에서 앱을 활성화할 때 명령줄 인수와 같은 정보를 제공합니다.

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

상속

Object Platform::Object IInspectable CommandLineActivatedEventArgs

특성

ContractVersionAttribute MarshalingBehaviorAttribute

구현

IActivatedEventArgs IActivatedEventArgsWithUser ICommandLineActivatedEventArgs

Windows 요구 사항

디바이스 패밀리	Windows 10 Fall Creators Update (10.0.16299.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v5.0에서 도입되었습니다.)

예제

다음은 명령줄 시작을 처리하는 예제입니다.

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

설명

UWP 앱이 시작에서 활성화될 수 있음 | Windows, PowerShell의 명령줄, DOS 명령 프롬프트 또는 CreateProcess()를 호출하는 다른 Win32 프로세스에서 를 실행합니다.

명령줄에서 활성화하려면 앱이 매니페스트의 "AppExecutionAlias" 확장 범주에 등록해야 합니다.

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

매니페스트에 등록한 후 명령줄에서 앱을 활성화할 수 있습니다. 앱이 활성화되면 이벤트 정보를 사용하여 호출 활성화를 식별하고 사용자에 대한 호출을 완료하는 데 도움이 되는 매개 변수를 추출할 수 있습니다.

속성

Kind	앱을 시작한 활성화 유형을 가져옵니다.
Operation	제공된 인수 및 현재 디렉터리 경로와 같은 앱 활성화에 대한 정보를 가져옵니다.
PreviousExecutionState	활성화되기 전에 앱의 실행 상태를 가져옵니다.
SplashScreen	시작 화면에서 활성화된 앱으로의 전환에 대한 정보를 가져옵니다.
User	앱이 활성화된 사용자를 가져옵니다.