Application Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Xaml

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Incapsula l'app e i relativi servizi disponibili.

/// [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 />

Ereditarietà: Object IInspectable Application

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

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

punto di ingresso dell'app, in particolare per vari contratti di attivazione
gestione della durata 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 classe che deriva da Application e fornisce un App punto di ingresso in cui è possibile aggiungere 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 il codice per associare gestori agli eventi dell'applicazione. Per altri codici di inizializzazione, è necessario eseguire l'override di uno o più metodi di inizializzazione, ad esempio OnLaunched.

Il sistema gestisce la durata dell'app sospendendo l'app ogni volta che l'utente passa a un'altra app o al desktop e riprende l'app ogni volta che l'utente lo torna. Tuttavia, il sistema può anche terminare l'app mentre è sospeso per liberare risorse. È necessario gestire l'evento Sospensione per salvare lo stato dell'app in caso di terminazione ed eseguire l'override del metodo OnLaunched per ripristinare lo stato dell'app. È consigliabile gestire l'evento Ripresa solo se è necessario aggiornare qualsiasi contenuto visualizzato che potrebbe essere stato modificato durante la sospensione dell'app. Non è necessario ripristinare lo stato dell'altra app quando l'app riprende.

A causa della sua posizione nel modello di applicazione, codicegeno e sequenza di attivazione, l'applicazione ha alcune restrizioni sull'utilizzo 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 del modello di progetto App.xaml, esistono dipendenze aggiuntive sull'uso dello schema di denominazione esistente nelle azioni di compilazione.
Non collegare i gestori eventi dell'applicazione in XAML. Tutti i collegamenti eventi devono essere eseguiti nel codice (in genere nel costruttore). In genere si usano le sostituzioni del metodo anziché la sintassi degli eventi per un evento, ad esempio OnActivated per rispondere a tale fase del ciclo di vita dell'applicazione.
Le uniche proprietà previste in un'istanza di Application in XAML sono il set di elementi per popolare la proprietà Application.Resources usando un utilizzo degli elementi delle proprietà XAML. Per altre informazioni, vedere Risorse. Per fornire la gestione generale degli errori per eventuali eccezioni che il codice dell'app non rileva, gestire l'evento UnhandledException .

Nota

Il file principale dell'applicazione deve essere denominato App.xaml.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	EnteredBackground
1607	14393	FocusVisualKind
1607	14393	LeavingBackground
1607	14393	OnBackgroundActivated
1607	14393	RichiedePointerMode
1703	15063	HighContrastAdjustment

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 quando viene eseguito in un ambiente di debug.
FocusVisualKind	Ottiene o imposta il tipo di feedback visivo che un'app può usare per indicare l'elemento dell'interfaccia utente con lo stato attivo. Questa proprietà è valida solo per i dispositivi di input che possono generare eventi chiave, ad esempio una tastiera o un pad di gioco.
HighContrastAdjustment	Ottiene o imposta un valore che indica se il framework regola automaticamente le proprietà visive quando sono abilitati temi a contrasto elevato.
RequestedTheme	Ottiene o imposta un valore che determina la preferenza chiaro-scuro per il tema complessivo di un'app.
RequiresPointerMode	Ottiene o imposta se un'app UWP supporta la modalità mouse, che emula le esperienze di interazione del puntatore con dispositivi di input non puntatore, ad esempio un pad del gioco o un controllo remoto. Tutti gli elementi annidati ereditano questo comportamento.
Resources	Ottiene una raccolta di risorse con ambito applicazione, ad esempio stili, modelli e pennelli.

Metodi

Exit()	Arresta l'app.
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.
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.
OnActivated(IActivatedEventArgs)	Richiamato quando l'applicazione viene attivata da alcuni mezzi diversi dall'avvio normale.
OnBackgroundActivated(BackgroundActivatedEventArgs)	Richiamato quando l'applicazione viene attivata in background.
OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)	Richiamato quando l'applicazione viene attivata a causa di un contratto di attivazione con ActivationKind come CachedFileUpdater.
OnFileActivated(FileActivatedEventArgs)	Richiamato quando l'applicazione viene attivata tramite file aperto.
OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)	Richiamato quando l'applicazione viene attivata tramite l'associazione di dialoghi aperta dal file.
OnFileSavePickerActivated(FileSavePickerActivatedEventArgs)	Richiamato quando l'applicazione viene attivata tramite l'associazione di dialoghi di salvataggio file.
OnLaunched(LaunchActivatedEventArgs)	Richiamato quando viene avviata l'applicazione. Eseguire l'override di questo metodo per eseguire l'inizializzazione dell'applicazione e visualizzare il contenuto iniziale nella finestra associata.
OnSearchActivated(SearchActivatedEventArgs)	Richiamato quando l'applicazione viene attivata tramite un'associazione di ricerca.
OnShareTargetActivated(ShareTargetActivatedEventArgs)	Richiamato quando l'applicazione viene attivata tramite l'associazione di condivisione.
OnWindowCreated(WindowCreatedEventArgs)	Richiamato quando l'applicazione crea una finestra.
Start(ApplicationInitializationCallback)	Fornisce il punto di ingresso e le richieste di inizializzazione dell'applicazione. Usare il callback per creare un'istanza della classe Application .

Eventi

EnteredBackground	Si verifica quando l'app passa in primo piano allo sfondo.
LeavingBackground	Si verifica quando l'app passa dallo sfondo al primo piano.
Resuming	Si verifica quando l'applicazione passa dallo stato Sospeso allo stato In esecuzione.
Suspending	Si verifica quando l'applicazione passa allo stato sospeso da un altro stato.
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