Application Classe
Definizione
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.
Incapsula un'applicazione Windows Presentation Foundation.
public ref class Application : System::Windows::Threading::DispatcherObject
public ref class Application : System::Windows::Threading::DispatcherObject, System::Windows::Markup::IQueryAmbient
public class Application : System.Windows.Threading.DispatcherObject
public class Application : System.Windows.Threading.DispatcherObject, System.Windows.Markup.IQueryAmbient
type Application = class
inherit DispatcherObject
type Application = class
inherit DispatcherObject
interface IQueryAmbient
Public Class Application
Inherits DispatcherObject
Public Class Application
Inherits DispatcherObject
Implements IQueryAmbient
- Ereditarietà
- Implementazioni
Esempio
L'esempio seguente illustra come viene definita un'applicazione standard usando solo markup:
<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" />
L'esempio seguente illustra come viene definita un'applicazione standard usando solo il codice:
using System;
using System.Windows;
namespace SDKSample
{
public class AppCode : Application
{
// Entry point method
[STAThread]
public static void Main()
{
AppCode app = new AppCode();
app.Run();
}
}
}
Imports System.Windows
Namespace SDKSample
Public Class AppCode
Inherits Application
' Entry point method
<STAThread>
Public Shared Sub Main()
Dim app As New AppCode()
app.Run()
End Sub
End Class
End Namespace
Nell'esempio seguente viene illustrato come viene definita un'applicazione standard usando una combinazione di markup e code-behind.
<Application
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
x:Class="SDKSample.App" />
using System.Windows;
namespace SDKSample
{
public partial class App : Application { }
}
Imports System.Windows
Namespace SDKSample
Partial Public Class App
Inherits Application
End Class
End Namespace
Commenti
Application è una classe che incapsula macchine virtuali Windows funzionalità specifiche dell'applicazione, tra cui:
Durata dell'applicazione: Activated, DeactivatedCurrent, , ExitDispatcherUnhandledException, Run, ShutdownSessionEnding, , ShutdownMode, . Startup
Application-Scope Window, Property e Resource Management: FindResource, GetContentStream, GetResourceStream, LoadComponent, MainWindow, Properties, Resources, StartupUri, Windows.
Command-Line l'elaborazione del codice di uscita e del parametro: Application.Startup, Application.Exit, Application.Shutdown.
Navigazione: FragmentNavigation, LoadCompleted, Navigated, Navigating, NavigationProgressNavigationStopped, NavigationFailed, , SetCookie, . GetCookie
Application implementa il modello singleton per fornire l'accesso condiviso ai servizi finestra, proprietà e ambito delle risorse. Di conseguenza, è possibile creare una sola istanza della Application classe per AppDomain.
È possibile implementare un oggetto Application usando markup, markup e code-behind o codice. Se Application viene implementato con markup, sia markup che markup e code-behind, il file di markup deve essere configurato come elemento Microsoft motore di compilazione (MSBuild) ApplicationDefinition.
Note
Un'applicazione autonoma non richiede un Application oggetto. È possibile implementare un metodo di punto di ingresso personalizzato static (Main) che apre una finestra senza creare un'istanza di Application. Tuttavia, le applicazioni browser XAML (XBAP) richiedono un Application oggetto .
Costruttori
| Nome | Descrizione |
|---|---|
| Application() |
Inizializza una nuova istanza della classe Application. |
Proprietà
| Nome | Descrizione |
|---|---|
| Current |
Ottiene l'oggetto Application per l'oggetto corrente AppDomain. |
| Dispatcher |
Ottiene l'oggetto DispatcherDispatcherObject a cui è associato. (Ereditato da DispatcherObject) |
| MainWindow |
Ottiene o imposta la finestra principale dell'applicazione. |
| Properties |
Ottiene una raccolta di proprietà dell'ambito applicazione. |
| ResourceAssembly |
Ottiene o imposta l'Assembly che fornisce gli URI (Uniform Resource Identifier) pack per le risorse in un'applicazione macchine virtuali Windows. |
| Resources |
Ottiene o imposta una raccolta di risorse dell'ambito applicazione, ad esempio stili e pennelli. |
| ShutdownMode |
Ottiene o imposta la condizione che determina la chiamata del Shutdown() metodo. |
| StartupUri |
Ottiene o imposta un'interfaccia utente visualizzata automaticamente all'avvio di un'applicazione. |
| Windows |
Ottiene le finestre di cui è stata creata un'istanza in un'applicazione. |
Metodi
| Nome | Descrizione |
|---|---|
| CheckAccess() |
Determina se il thread chiamante ha accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| FindResource(Object) |
Cerca una risorsa dell'interfaccia utente, ad esempio o StyleBrush, con la chiave specificata e genera un'eccezione se la risorsa richiesta non viene trovata (vedi Risorse XAML). |
| GetContentStream(Uri) |
Restituisce un flusso di risorse per un file di dati del contenuto che si trova nel Uri specificato (vedere macchine virtuali Windows Risorsa applicazione, Contenuto e File di dati). |
| GetCookie(Uri) |
Recupera un cookie per il percorso specificato da un oggetto Uri. |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetRemoteStream(Uri) |
Restituisce un flusso di risorse per un file di dati di origine sito che si trova nel Uri specificato (vedere macchine virtuali Windows Risorsa applicazione, Contenuto e File di dati). |
| GetResourceStream(Uri) |
Restituisce un flusso di risorse per un file di dati di risorse che si trova nel Uri specificato (vedere macchine virtuali Windows Risorsa applicazione, Contenuto e File di dati. |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| LoadComponent(Object, Uri) |
Carica un file XAML che si trova nell'URI (Uniform Resource Identifier) specificato e lo converte in un'istanza dell'oggetto specificato dall'elemento radice del file XAML. |
| LoadComponent(Uri) |
Carica un file XAML che si trova nell'URI (Uniform Resource Identifier) specificato e lo converte in un'istanza dell'oggetto specificato dall'elemento radice del file XAML. |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnActivated(EventArgs) |
Genera l'evento Activated. |
| OnDeactivated(EventArgs) |
Genera l'evento Deactivated. |
| OnExit(ExitEventArgs) |
Genera l'evento Exit. |
| OnFragmentNavigation(FragmentNavigationEventArgs) |
Genera l'evento FragmentNavigation. |
| OnLoadCompleted(NavigationEventArgs) |
Genera l'evento LoadCompleted. |
| OnNavigated(NavigationEventArgs) |
Genera l'evento Navigated. |
| OnNavigating(NavigatingCancelEventArgs) |
Genera l'evento Navigating. |
| OnNavigationFailed(NavigationFailedEventArgs) |
Genera l'evento NavigationFailed. |
| OnNavigationProgress(NavigationProgressEventArgs) |
Genera l'evento NavigationProgress. |
| OnNavigationStopped(NavigationEventArgs) |
Genera l'evento NavigationStopped. |
| OnSessionEnding(SessionEndingCancelEventArgs) |
Genera l'evento SessionEnding. |
| OnStartup(StartupEventArgs) |
Genera l'evento Startup. |
| Run() |
Avvia un'applicazione Windows Presentation Foundation. |
| Run(Window) |
Avvia un'applicazione Windows Presentation Foundation e apre la finestra specificata. |
| SetCookie(Uri, String) |
Crea un cookie per la posizione specificata da un oggetto Uri. |
| Shutdown() |
Arresta un'applicazione. |
| Shutdown(Int32) |
Arresta un'applicazione che restituisce il codice di uscita specificato al sistema operativo. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| TryFindResource(Object) |
Cerca la risorsa specificata. |
| VerifyAccess() |
Impone che il thread chiamante abbia accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject) |
Eventi
| Nome | Descrizione |
|---|---|
| Activated |
Si verifica quando un'applicazione diventa l'applicazione in primo piano. |
| Deactivated |
Si verifica quando un'applicazione smette di essere l'applicazione in primo piano. |
| DispatcherUnhandledException |
Si verifica quando un'eccezione viene generata da un'applicazione ma non gestita. |
| Exit |
Si verifica subito prima dell'arresto di un'applicazione e non può essere annullata. |
| FragmentNavigation |
Si verifica quando uno strumento di spostamento nell'applicazione inizia a spostarsi in un frammento di contenuto, la navigazione si verifica immediatamente se il frammento desiderato si trova nel contenuto corrente o dopo il caricamento del contenuto XAML di origine se il frammento desiderato si trova in contenuto diverso. |
| LoadCompleted |
Si verifica quando il contenuto a cui è stato eseguito lo spostamento da uno strumento di spostamento nell'applicazione è stato caricato, analizzato e ha iniziato il rendering. |
| Navigated |
Si verifica quando il contenuto a cui si passa da uno strumento di navigazione nell'applicazione è stato trovato, anche se potrebbe non aver completato il caricamento. |
| Navigating |
Si verifica quando viene richiesta una nuova navigazione da uno strumento di spostamento nell'applicazione. |
| NavigationFailed |
Si verifica quando si verifica un errore mentre uno strumento di spostamento nell'applicazione passa al contenuto richiesto. |
| NavigationProgress |
Si verifica periodicamente durante un download gestito da uno strumento di navigazione nell'applicazione per fornire informazioni sullo stato di spostamento. |
| NavigationStopped |
Si verifica quando viene chiamato il |
| SessionEnding |
Si verifica quando l'utente termina la sessione di Windows disconnettendo o arrestando il sistema operativo. |
| Startup |
Si verifica quando viene chiamato il Run() metodo dell'oggetto Application . |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
Esegue una query per verificare se una proprietà di ambiente specificata è disponibile nell'ambito corrente. |
Si applica a
Thread safety
I membri public static (Shared in Visual Basic) di questo tipo sono thread-safe. Inoltre, i FindResource(Object) metodi e TryFindResource(Object) e le Properties proprietà e Resources sono thread-safe.