AppInstance Kelas
Definisi
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.
Mewakili instans aplikasi.
public ref class AppInstance sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppInstance final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppInstance
Public NotInheritable Class AppInstance
- Warisan
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10, version 1803 (diperkenalkan dalam 10.0.17134.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v6.0)
|
Keterangan
Sistem ini mempertahankan penyimpanan instans aplikasi. Aplikasi dapat menggunakan ini untuk pengalihan aplikasi saat mencoba mengaktifkan.
Saat proses aplikasi dibuat dalam Main
metode aplikasi, ia dapat memilih untuk terus mengaktifkan instans saat ini, atau untuk mengalihkan aktivasi ke instans yang ada.
Shell dapat menyediakan instans pilihan untuk pengalihan. Aplikasi ini didorong untuk mengalihkan ke instans tersebut. Pilihan apakah akan mengalihkan tetap dengan aplikasi.
Kelas AppInstance dimaksudkan untuk digunakan dalam Main
metode aplikasi. Jika kelas ini digunakan nanti, nilai properti mungkin null
, dan metode mungkin gagal.
Sebelum instans apa pun dapat dikembalikan, instans tersebut harus didaftarkan ke FindOrRegisterInstanceForKey.
Kelas ini hanya dapat digunakan dari aplikasi yang telah memilih untuk multi-instancing. Tentukan atribut SupportsMultipleInstances pada elemen Aplikasi dalam manifes paket untuk aplikasi.
Properti
IsCurrentInstance |
Apakah instans aplikasi saat ini adalah instans aplikasi terdaftar untuk kunci tertentu yang telah ditentukan instans ini. |
Key |
Kunci untuk instans saat ini. |
RecommendedInstance |
Shell dapat merekomendasikan instans aplikasi tempat aktivasi aplikasi dialihkan. |
Metode
FindOrRegisterInstanceForKey(String) |
Mendaftarkan instans aplikasi dengan platform, atau menemukan instans yang ada jika instans lain telah mendaftarkan kunci ini. |
GetActivatedEventArgs() |
Mendapatkan IActivatedEventArgs saat ini, sama yang biasanya akan diteruskan ke metode OnActivated aplikasi. |
GetInstances() |
Mendapatkan instans terdaftar dari aplikasi saat ini. |
RedirectActivationTo() |
Mengalihkan aktivasi instans aplikasi saat ini ke instans yang ditentukan. |
Unregister() |
Updates cache sistem sehingga instans saat ini tidak lagi tersedia untuk pengalihan aktivasi. |