Application Kelas

Definisi

Ruang nama:

Microsoft.UI.Xaml

Mewakili aplikasi saat ini dan layanan yang tersedia.

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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

Keterangan

Kelas Application merangkum aplikasi dan menyediakan layanan berikut:

• titik entri aplikasi
• sumber daya cakupan aplikasi
• deteksi pengecualian yang tidak tertangani

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

Kelas mengaitkan App 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 untuk peristiwa UnhandledException atau mengatur RequestedTheme. Anda harus meletakkan kode inisialisasi lain dalam penimpaan metode OnLaunched .

Tip

Untuk informasi selengkapnya, lihat siklus hidup aplikasi SDK Aplikasi Windows.

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

• Selain deklarasi xmlns dan x:Class, tidak ada atribut lain yang dapat muncul pada Application tag root.
• Jangan mencoba mengubah nilai x:Class yang berasal dari halaman App.xaml templat proyek, ada dependensi tambahan tentang penggunaan skema penamaan yang ada dalam tindakan build.
• Jangan kawat penanganan Application aktivitas di XAML. Semua kabel peristiwa harus dilakukan dalam kode (biasanya di konstruktor).
• Satu-satunya properti yang Application diharapkan pada instans 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 .

Note

File Application utama harus diberi nama App.xaml.

Konstruktor

Nama	Deskripsi
Application()	Menginisialisasi instans baru kelas Aplikasi .

Properti

Nama	Deskripsi
Current	Mendapatkan objek Aplikasi untuk aplikasi saat ini.
DebugSettings	Mendapatkan objek yang menyatakan bagaimana aplikasi berperilaku saat dijalankan di lingkungan debug.
DispatcherShutdownMode	Mendapatkan atau menetapkan nilai yang menentukan apakah perulangan peristiwa DispatcherQueue keluar ketika semua jendela XAML pada utas ditutup.
FocusVisualKind	Mendapatkan atau mengatur jenis umpan balik visual yang dapat digunakan aplikasi untuk menunjukkan elemen UI yang memiliki fokus.
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 terang-gelap untuk tema keseluruhan aplikasi.
Resources	Mendapatkan kumpulan sumber daya cakupan aplikasi, seperti gaya, templat, dan kuas.

Metode

Nama	Deskripsi
Exit()	Mematikan aplikasi.
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.
LoadComponent(Object, Uri)	Memuat file XAML yang terletak di lokasi relatif yang ditentukan, dan mengonversinya ke instans objek yang ditentukan oleh elemen akar file XAML.
OnLaunched(LaunchActivatedEventArgs)	Dipanggil saat aplikasi diluncurkan. Ambil alih metode ini untuk melakukan inisialisasi aplikasi dan membuat jendela baru.
Start(ApplicationInitializationCallback)	Menyediakan titik masuk dan permintaan inisialisasi aplikasi. Gunakan ApplicationInitializationCallback yang ditentukan untuk membuat instans kelas Aplikasi .

Acara

Nama	Deskripsi
ResourceManagerRequested	Terjadi selama startup utas WinUI baru untuk memungkinkan Anda menyediakan implementasi kustom IResourceManager yang akan digunakan oleh kerangka kerja untuk menyelesaikan URI sumber daya.
UnhandledException	Terjadi ketika pengecualian dapat ditangani oleh kode aplikasi, seperti yang diteruskan dari kesalahan Windows Runtime tingkat asli. Aplikasi dapat menandai kemunculan sebagai ditangani dalam data peristiwa.

Lihat juga

• Window
• siklus hidup aplikasi SDK Aplikasi Windows