Application Kelas

Referensi

Definisi

Ruang nama:: Microsoft.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

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 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 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 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 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 .

Catatan

File Application utama harus diberi nama App.xaml.

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.
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 gelap terang untuk tema keseluruhan aplikasi.
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.
OnLaunched(LaunchActivatedEventArgs)	Dipanggil ketika 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

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 seperti yang ditangani dalam data peristiwa.

Berlaku untuk

Bagikan melalui