CoreApplication Kelas
Definisi
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.
Memungkinkan aplikasi menangani perubahan status, mengelola jendela, dan berintegrasi dengan berbagai kerangka kerja UI.
public ref class CoreApplication abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreApplication final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class CoreApplication
Public Class CoreApplication
- Warisan
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Keterangan
Sistem membuat objek ini sebagai singleton saat menjalankan aplikasi. Ini dijalankan sebagai Application Single-Threaded Apartment (ASTA). Utas yang dibuat dari singleton aplikasi, seperti penyedia tampilan (terlihat dalam sampel di bawah), harus diatribusikan sebagai Apartemen Multi-Utas (MTAThread).
API ini hanya didukung di aplikasi Universal Windows Platform, kecuali properti Properti , yang selalu tersedia.
struct App : implements<App, IFrameworkViewSource, IFrameworkView>
{
public:
IFrameworkView CreateView()
{
return *this;
}
};
...
int __stdcall wWinMain(HINSTANCE, HINSTANCE, PWSTR, int)
{
Windows::ApplicationModel::Core::CoreApplication::Run(App());
}
ref class MyFrameworkViewSource : IFrameworkViewSource
{
public:
virtual IFrameworkView^ CreateView()
{
return ref new MyFrameworkView();
}
};
// ...
[Platform::MTAThread]
int main(Platform::Array<Platform::String^>^)
{
auto frameworkViewSource = ref new MyFrameworkViewSource();
Windows::ApplicationModel::Core::CoreApplication::Run(frameworkViewSource);
return 0;
}
internal class ApplicationSource : IFrameworkViewSource
{
public virtual IFrameworkView CreateView()
{
return new CoreApp();
}
}
...
[MTAThread]
public static int Main()
{
var appSource = new ApplicationSource();
CoreApplication.Run(appSource);
return 0;
}
Riwayat versi
Versi Windows | Versi SDK | Nilai ditambahkan |
---|---|---|
1607 | 14393 | Latar Belakang Diaktifkan |
1607 | 14393 | EnablePrelaunch |
1607 | 14393 | EnteredBackground |
1607 | 14393 | LeavingBackground |
1709 | 16299 | RequestRestartAsync |
1709 | 16299 | RequestRestartForUserAsync |
Properti
Id |
Mendapatkan pengidentifikasi aplikasi relatif paket untuk proses tersebut. |
MainView |
Mendapatkan instans CoreApplicationView utama untuk semua aplikasi yang berjalan yang menggunakan instans CoreApplication ini. |
Properties |
Mendapatkan kumpulan properti yang dapat digunakan kerangka kerja aplikasi dan UI untuk menyimpan info saat proses sedang berjalan. |
Views |
Mendapatkan semua tampilan untuk aplikasi. |
Metode
CreateNewView() |
Membuat tampilan baru untuk aplikasi. |
CreateNewView(IFrameworkViewSource) |
Membuat tampilan baru untuk aplikasi. |
CreateNewView(String, String) |
Membuat tampilan baru untuk aplikasi. |
DecrementApplicationUseCount() |
Mengurangi jumlah total instans aplikasi yang berjalan yang menggunakan instans CoreApplication ini. |
EnablePrelaunch(Boolean) |
Aktifkan atau nonaktifkan kemampuan sistem operasi untuk meluncurkan aplikasi Anda sebelumnya. |
Exit() |
Mematikan aplikasi. |
GetCurrentView() |
Mendapatkan tampilan yang sesuai dengan utas saat ini. |
IncrementApplicationUseCount() |
Menambahkan jumlah total instans aplikasi yang berjalan yang menggunakan instans CoreApplication ini. |
RequestRestartAsync(String) |
Mulai ulang aplikasi. |
RequestRestartForUserAsync(User, String) |
Mulai ulang aplikasi dalam konteks pengguna yang berbeda. |
Run(IFrameworkViewSource) |
Menjalankan pabrik penyedia tampilan eksternal untuk mendapatkan penyedia tampilan. |
RunWithActivationFactories(IGetActivationFactory) |
Menjalankan pabrik jenis yang dapat diaktifkan untuk mendapatkan jenis eksternal yang dapat diaktifkan. |
Acara
BackgroundActivated |
Diaktifkan saat aplikasi Anda diaktifkan oleh pemicu latar belakang. |
EnteredBackground |
Diaktifkan saat aplikasi memasuki proses berjalan dalam status latar belakang. |
Exiting |
Terjadi saat aplikasi dimatikan. |
LeavingBackground |
Diaktifkan tepat sebelum UI aplikasi terlihat. |
Resuming |
Terjadi saat aplikasi melanjutkan. |
Suspending |
Terjadi saat aplikasi ditangguhkan. |
UnhandledErrorDetected |
Terjadi ketika ada kesalahan mendasar yang dirutekan ke instans CoreApplication , sebagai bagian dari logika penanganan kesalahan global. |