CoreApplication.RequestRestartAsync(String) Metode

Referensi

Definisi

Ruang nama:: Windows.ApplicationModel.Core

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

Mulai ulang aplikasi.

public:
 static IAsyncOperation<AppRestartFailureReason> ^ RequestRestartAsync(Platform::String ^ launchArguments);

/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<AppRestartFailureReason> RequestRestartAsync(winrt::hstring const& launchArguments);

[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<AppRestartFailureReason> RequestRestartAsync(string launchArguments);

function requestRestartAsync(launchArguments)

Public Shared Function RequestRestartAsync (launchArguments As String) As IAsyncOperation(Of AppRestartFailureReason)

Parameter

launchArguments: String
Platform::String

winrt::hstring

Argumen yang akan diteruskan ke instans yang dimulai ulang.

Mengembalikan

IAsyncOperation<AppRestartFailureReason>

Status permintaan hidupkan ulang.

Atribut: RemoteAsyncAttribute

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

private async void DoMajorAppReconfiguration()
{
    // Attempt restart, with arguments.
    AppRestartFailureReason result =
        await CoreApplication.RequestRestartAsync("-fastInit -level 1 -foo");

    // Restart request denied, send a toast to tell the user to restart manually.
    if (result == AppRestartFailureReason.NotInForeground
        || result == AppRestartFailureReason.Other)
    {
        SendToast("Please manually restart.");
    }
}

Keterangan

Aplikasi harus terlihat dan latar depan saat memanggil API ini.
Jika hidupkan ulang gagal, tetapi pengguna kemudian meluncurkan aplikasi secara manual, aplikasi akan diluncurkan secara normal dan tidak ada argumen hidupkan ulang yang akan diteruskan.
Jika aplikasi tidak diluncurkan dengan cara normal, tetapi diluncurkan oleh kontrak berbagi, pemilih file, layanan aplikasi, dan sebagainya, aplikasi tidak boleh memanggil API ini karena pengguna tidak akan mengharapkan perilaku yang dihasilkan.
Aplikasi tidak boleh meminta sesi Eksekusi diperpanjang setelah memanggil API ini karena akan mengakibatkan pengalaman pengguna yang buruk.
Jika aplikasi memiliki tugas latar belakang dalam proses yang berjalan saat memanggil API ini, tugas tersebut akan dibatalkan dengan cara normal. Tugas latar belakang di luar proses tidak akan terpengaruh.
Saat aplikasi dimulai ulang, LaunchActivatedEventArgs.PreviousExecutionState akan memiliki nilai Dihentikan sehingga aplikasi dapat membedakan antara resume dan restart.

Berlaku untuk

Bagikan melalui