Application Classe

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml
Modifica

Rappresenta l'applicazione corrente e i relativi servizi disponibili.

/// [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 />
Ereditarietà
Object IInspectable Application
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Commenti

La Application classe incapsula un'app e fornisce i servizi seguenti:

  • punto di ingresso dell'app
  • risorse con ambito app
  • rilevamento delle eccezioni non gestite

L'oggetto Application viene in genere fornito nel codice XAML iniziale per App.xaml. I modelli di progetto predefiniti in Visual Studio generano una App classe che deriva da Application e fornisce un punto di ingresso in cui è possibile aggiungere il codice di inizializzazione.

La App classe si associa al codice XAML corrispondente chiamando il metodo generato InitializeComponent nel relativo costruttore. È possibile aggiungere codice di inizializzazione aggiuntivo al App costruttore, ma in genere si aggiungerà solo codice per associare un gestore per l'evento UnhandledException o impostare RequestedTheme. È necessario inserire altro codice di inizializzazione nell'override del metodo OnLaunched .

Suggerimento

Per altre info, vedi SDK per app di Windows ciclo di vita dell'app.

A causa della posizione nel modello dell'applicazione, nel codegen e nella sequenza di attivazione, Application esistono alcune restrizioni per l'utilizzo di XAML:

  • Oltre alle dichiarazioni xmlns e x:Class, nessun altro attributo può essere visualizzato nel Application tag radice.
  • Non tentare di modificare i valori x:Class provenienti dalle pagine app.xaml del modello di progetto, esistono dipendenze aggiuntive sull'uso di tale schema di denominazione esistente nelle azioni di compilazione.
  • Non collegare i Application gestori eventi in XAML. Tutto il cablaggio degli eventi deve essere eseguito nel codice (in genere nel costruttore).
  • Le uniche proprietà previste per un'istanza Application in XAML sono il set di elementi da popolare la proprietà Application.Resources , usando un utilizzo degli elementi proprietà XAML. Per altre info, vedi Risorse.
  • Per fornire una gestione generale degli errori per eventuali eccezioni che il codice dell'app non rileva, gestire l'evento UnhandledException .

Nota

Il Application file principale deve essere denominato App.xaml.

Costruttori

Application()

Inizializza una nuova istanza della classe Application .

Proprietà

Current

Ottiene l'oggetto Application per l'applicazione corrente.
DebugSettings

Ottiene un oggetto che dichiara il comportamento dell'app durante l'esecuzione in un ambiente di debug.
DispatcherShutdownMode

Ottiene o imposta un valore che specifica se il ciclo di eventi DispatcherQueue viene chiuso quando vengono chiuse tutte le finestre XAML di un thread.
FocusVisualKind

Ottiene o imposta il tipo di feedback visivo che un'app può usare per indicare l'elemento dell'interfaccia utente con stato attivo.
HighContrastAdjustment

Ottiene o imposta un valore che indica se il framework regola automaticamente le proprietà visive quando i temi a contrasto elevato sono abilitati.
RequestedTheme

Ottiene o imposta un valore che determina la preferenza chiara e scura per il tema complessivo di un'app.
Resources

Ottiene una raccolta di risorse con ambito applicazione, ad esempio stili, modelli e pennelli.

Metodi

Exit()

Arresta l'app.
LoadComponent(Object, Uri, ComponentResourceLocation)

Carica un file XAML che si trova nel percorso relativo specificato e lo converte in un'istanza dell'oggetto specificato dall'elemento radice del file XAML.
LoadComponent(Object, Uri)

Carica un file XAML che si trova nel percorso relativo specificato e lo converte in un'istanza dell'oggetto specificato dall'elemento radice del file XAML.
OnLaunched(LaunchActivatedEventArgs)

Richiamato all'avvio dell'applicazione. Eseguire l'override di questo metodo per eseguire l'inizializzazione dell'applicazione e creare una nuova finestra.
Start(ApplicationInitializationCallback)

Fornisce il punto di ingresso e richiede l'inizializzazione dell'applicazione. Usare l'oggetto ApplicationInitializationCallback specificato per creare un'istanza della classe Application .

Eventi

ResourceManagerRequested

Si verifica durante l'avvio di un nuovo thread WinUI per consentire di fornire un'implementazione personalizzata IResourceManager da usare dal framework per la risoluzione degli URI delle risorse.
UnhandledException

Si verifica quando un'eccezione può essere gestita dal codice dell'app, come inoltrato da un errore di Windows Runtime a livello nativo. Le app possono contrassegnare l'occorrenza come gestita nei dati dell'evento.

Si applica a

Vedi anche