CommandLineActivatedEventArgs Kelas

Referensi

Definisi

Ruang nama:: Windows.ApplicationModel.Activation

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Menyediakan informasi, seperti argumen baris perintah, saat aplikasi diaktifkan dari baris perintah.

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

Warisan: Object Platform::Object IInspectable CommandLineActivatedEventArgs

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute

Penerapan: IActivatedEventArgs IActivatedEventArgsWithUser ICommandLineActivatedEventArgs

Persyaratan Windows

Rangkaian perangkat	Windows 10 Fall Creators Update (diperkenalkan dalam 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v5.0)

Contoh

Berikut adalah contoh penanganan peluncuran baris perintah:

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

Keterangan

Aplikasi UWP dapat diaktifkan dari Mulai|Jalankan di Windows, dari baris perintah di PowerShell, prompt perintah DOS, atau dari proses Win32 lain yang memanggil CreateProcess().

Untuk diaktifkan dari baris perintah, aplikasi Anda harus mendaftar untuk kategori ekstensi "AppExecutionAlias" dalam manifesnya.

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

Setelah mendaftar dalam manifes, aplikasi Anda dapat diaktifkan dari baris perintah. Saat aplikasi diaktifkan, Anda dapat menggunakan informasi peristiwa untuk mengidentifikasi aktivasi panggilan dan mengekstrak parameter yang membantu Anda menyelesaikan panggilan untuk pengguna.

Properti

Kind	Mendapatkan jenis aktivasi yang meluncurkan aplikasi.
Operation	Mendapatkan info tentang aktivasi aplikasi seperti argumen apa yang disediakan dan jalur direktori saat ini.
PreviousExecutionState	Mendapatkan status eksekusi aplikasi sebelum diaktifkan.
SplashScreen	Mendapatkan info tentang transisi dari layar splash ke aplikasi yang diaktifkan.
User	Mendapatkan pengguna tempat aplikasi diaktifkan.

Berlaku untuk

Bagikan melalui