CoreApplication Kelas

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

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: Object Platform::Object IInspectable CoreApplication

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute

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.

Berlaku untuk