Application Kelas

Referensi

Definisi

Ruang nama:: Windows.UI.Xaml

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

Merangkum aplikasi dan layanan yang tersedia.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Application

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Application

Public Class Application

<Application />

Warisan: Object IInspectable Application

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Kelas Aplikasi merangkum aplikasi dan menyediakan layanan berikut:

titik masuk aplikasi, terutama untuk berbagai kontrak aktivasi
manajemen masa pakai aplikasi
sumber daya cakupan aplikasi
deteksi pengecualian yang tidak tertangani

Objek Aplikasi biasanya disediakan dalam XAML awal untuk App.xaml. Templat proyek default di Visual Studio menghasilkan App kelas yang berasal dari Aplikasi dan menyediakan titik masuk tempat Anda dapat menambahkan kode inisialisasi.

Kelas ini App mengaitkan dirinya dengan XAML yang sesuai dengan memanggil metode yang dihasilkan InitializeComponent dalam konstruktornya. Anda dapat menambahkan kode inisialisasi tambahan ke App konstruktor, tetapi Anda biasanya hanya akan menambahkan kode untuk mengaitkan handler ke peristiwa Aplikasi. Untuk kode inisialisasi lainnya, Anda harus mengambil alih satu atau beberapa metode inisialisasi seperti OnLaunched.

Sistem menangani masa pakai aplikasi dengan menangguhkan aplikasi Anda setiap kali pengguna beralih ke aplikasi lain atau ke desktop, dan melanjutkan aplikasi Anda setiap kali pengguna beralih kembali ke aplikasi tersebut. Namun, sistem juga dapat menghentikan aplikasi Anda saat ditangguhkan untuk membebaskan sumber daya. Anda harus menangani peristiwa Penangguhan untuk menyimpan status aplikasi jika terjadi penghentian, dan mengambil alih metode OnLaunched untuk memulihkan status aplikasi Anda. Anda harus menangani peristiwa Melanjutkan hanya jika Anda perlu me-refresh konten yang ditampilkan yang mungkin telah berubah saat aplikasi ditangguhkan. Anda tidak perlu memulihkan status aplikasi lain saat aplikasi dilanjutkan.

Karena posisinya dalam model aplikasi, codegen, dan urutan aktivasi, Aplikasi memiliki beberapa batasan pada penggunaan XAML-nya:

Selain deklarasi xmlns dan x:Class, tidak ada atribut lain yang dapat muncul pada Application tag akar.
Jangan mencoba mengubah nilai x:Class yang berasal dari halaman App.xaml templat proyek, ada dependensi tambahan tentang menggunakan skema penamaan yang ada dalam tindakan build.
Jangan kawat penanganan aktivitas Aplikasi di XAML. Semua kabel peristiwa harus dilakukan dalam kode (biasanya di konstruktor). Selain itu, Anda umumnya menggunakan metode mengambil alih-alih sintaks peristiwa untuk peristiwa (misalnya, Anda mengambil alih OnActivated untuk merespons fase siklus hidup aplikasi tersebut.)
Satu-satunya properti yang diharapkan pada instans Aplikasi di XAML adalah sekumpulan elemen untuk mengisi properti Application.Resources , menggunakan penggunaan elemen properti XAML. Untuk informasi selengkapnya, lihat Sumber Daya. Untuk memberikan penanganan kesalahan umum untuk pengecualian apa pun yang tidak ditangkap kode aplikasi Anda, tangani peristiwa UnhandledException .

Catatan

File utama Aplikasi harus diberi nama App.xaml.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	EnteredBackground
1607	14393	FocusVisualKind
1607	14393	LeavingBackground
1607	14393	OnBackgroundActivated
1607	14393	RequiresPointerMode
1703	15063	HighContrastAdjustment

Konstruktor

Application()

Menginisialisasi instans baru kelas Aplikasi .

Properti

Current	Mendapatkan objek Aplikasi untuk aplikasi saat ini.
DebugSettings	Mendapatkan objek yang menyatakan bagaimana aplikasi berperilaku saat dijalankan di lingkungan debug.
FocusVisualKind	Mendapatkan atau mengatur jenis umpan balik visual yang dapat digunakan aplikasi untuk menunjukkan elemen UI dengan fokus. Properti ini hanya valid untuk perangkat input yang dapat menghasilkan peristiwa utama, seperti keyboard atau pad game.
HighContrastAdjustment	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kerangka kerja secara otomatis menyesuaikan properti visual saat tema kontras tinggi diaktifkan.
RequestedTheme	Mendapatkan atau menetapkan nilai yang menentukan preferensi gelap terang untuk tema keseluruhan aplikasi.
RequiresPointerMode	Mendapatkan atau mengatur apakah aplikasi UWP mendukung mode mouse, yang meniru pengalaman interaksi pointer dengan perangkat input non-pointer seperti game pad atau remote control. (Semua elemen berlapis mewarisi perilaku ini.)
Resources	Mendapatkan kumpulan sumber daya cakupan aplikasi, seperti gaya, templat, dan kuas.

Metode

Exit()	Mematikan aplikasi.
LoadComponent(Object, Uri)	Memuat file XAML yang terletak di lokasi relatif yang ditentukan, dan mengonversinya menjadi instans objek yang ditentukan oleh elemen akar file XAML.
LoadComponent(Object, Uri, ComponentResourceLocation)	Memuat file XAML yang terletak di lokasi relatif yang ditentukan, dan mengonversinya menjadi instans objek yang ditentukan oleh elemen akar file XAML.
OnActivated(IActivatedEventArgs)	Dipanggil ketika aplikasi diaktifkan dengan beberapa cara selain peluncuran normal.
OnBackgroundActivated(BackgroundActivatedEventArgs)	Dipanggil ketika aplikasi diaktifkan di latar belakang.
OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)	Dipanggil ketika aplikasi diaktifkan karena kontrak aktivasi dengan ActivationKind sebagai CachedFileUpdater.
OnFileActivated(FileActivatedEventArgs)	Dipanggil ketika aplikasi diaktifkan melalui buka file.
OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)	Dipanggil ketika aplikasi diaktifkan melalui asosiasi dialog buka file.
OnFileSavePickerActivated(FileSavePickerActivatedEventArgs)	Dipanggil ketika aplikasi diaktifkan melalui asosiasi dialog penyimpanan file.
OnLaunched(LaunchActivatedEventArgs)	Dipanggil ketika aplikasi diluncurkan. Ambil alih metode ini untuk melakukan inisialisasi aplikasi dan menampilkan konten awal di Jendela terkait.
OnSearchActivated(SearchActivatedEventArgs)	Dipanggil ketika aplikasi diaktifkan melalui asosiasi pencarian.
OnShareTargetActivated(ShareTargetActivatedEventArgs)	Dipanggil ketika aplikasi diaktifkan melalui asosiasi berbagi.
OnWindowCreated(WindowCreatedEventArgs)	Dipanggil saat aplikasi membuat jendela.
Start(ApplicationInitializationCallback)	Menyediakan titik masuk dan permintaan inisialisasi aplikasi. Gunakan panggilan balik untuk membuat instans kelas Aplikasi .

Acara

EnteredBackground	Terjadi saat aplikasi berpindah dari latar depan ke latar belakang.
LeavingBackground	Terjadi ketika aplikasi berpindah dari latar belakang ke latar depan.
Resuming	Terjadi ketika aplikasi beralih dari status Ditangguhkan ke status Berjalan.
Suspending	Terjadi ketika aplikasi beralih ke status Ditangguhkan dari beberapa status lain.
UnhandledException	Terjadi ketika pengecualian dapat ditangani oleh kode aplikasi, seperti yang diteruskan dari kesalahan Windows Runtime tingkat asli. Aplikasi dapat menandai kemunculan seperti yang ditangani dalam data peristiwa.

Berlaku untuk