Bagikan melalui


Application Kelas

Definisi

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

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

Lihat juga