Condividi tramite


Application Classe

Definizione

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

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

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

Vedi anche