Application Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows

Assembly:: PresentationFramework.dll

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à: Object

DispatcherObject
Application

Implementazioni: IQueryAmbient

Esempio

Nell'esempio seguente viene illustrato come viene definita un'applicazione standard usando solo markup:

<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" />

Nell'esempio seguente viene illustrato 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 funzionalità specifiche dell'applicazione WPF, tra cui quanto segue:

Durata dell'applicazione: Activated Deactivated Exit DispatcherUnhandledException Current SessionEnding Shutdown Run ShutdownMode, . Startup
Finestra ambito applicazione, proprietà e Gestione risorse: FindResource, MainWindow GetResourceStream GetContentStream Properties Resources LoadComponent StartupUri, . Windows
Parametro della riga di comando e elaborazione del codice di uscita: Application.Startup, , Application.Exit Application.Shutdown.
Navigazione: FragmentNavigation NavigationProgress Navigated LoadCompleted NavigationStopped NavigationFailed Navigating SetCookie, . GetCookie

Application implementa il modello singleton per fornire l'accesso condiviso ai servizi di ambito finestra, proprietà e risorse. Di conseguenza, è possibile creare una sola istanza della Application classe per AppDomain.

È possibile implementare un Application oggetto usando markup, markup e code-behind o codice. Se Application viene implementato con markup, indipendentemente dal markup o dal markup e dal code-behind, il file di markup deve essere configurato come elemento del motore di compilazione Microsoft (MSBuild). ApplicationDefinition

Nota

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 del browser XAML (XBAP) richiedono un Application oggetto.

Costruttori

Application()

Inizializza una nuova istanza della classe Application.

Proprietà

Current	Ottiene l'oggetto Application per l'oggetto AppDomain corrente.
Dispatcher	Ottiene l'oggetto Dispatcher associato a DispatcherObject. (Ereditato da DispatcherObject)
MainWindow	Ottiene o imposta la finestra principale dell'applicazione.
Properties	Ottiene un insieme di proprietà dell'ambito dell'applicazione.
ResourceAssembly	Ottiene o imposta l'oggetto Assembly che fornisce gli URI (Uniform Resource Identifier) pack per le risorse in un'applicazione WPF.
Resources	Ottiene o imposta un insieme di risorse dell'ambito dell'applicazione, ad esempio stili e pennelli.
ShutdownMode	Ottiene o imposta la condizione che provoca la chiamata al metodo Shutdown().
StartupUri	Ottiene o imposta un'interfaccia utente che viene visualizzata automaticamente all'avvio di un'applicazione.
ThemeMode	Incapsula un'applicazione Windows Presentation Foundation.
Windows	Ottiene le finestre di cui è stata creata un'istanza in un'applicazione.

Metodi

CheckAccess()	Determina se il thread chiamante ha accesso a DispatcherObject. (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 un oggetto Style o Brush, con la chiave specificata e genera un'eccezione se la risorsa richiesta non viene trovata (vedere Risorse XAML).
GetContentStream(Uri)	Restituisce un flusso di risorsa per un file di dati di contenuto situato in corrispondenza dell'oggetto Uri specificato. Vedere WPF Application Resource, Content, and Data Files (File di dati, di contenuto e di risorse dell'applicazione WPF).
GetCookie(Uri)	Recupera un cookie per il percorso specificato da Uri.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetRemoteStream(Uri)	Restituisce un flusso di risorsa per un file di dati del sito di origine situato in corrispondenza dell'oggetto Uri specificato. Vedere WPF Application Resource, Content, and Data Files (File di dati, di contenuto e di risorse dell'applicazione WPF).
GetResourceStream(Uri)	Restituisce un flusso di risorsa per un file di dati della risorsa situato in corrispondenza dell'oggetto Uri specificato. Vedere WPF Application Resource, Content, and Data Files (File di dati, di contenuto e di risorse dell'applicazione WPF).
GetType()	Ottiene l'oggetto 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 dell'oggetto Object corrente. (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 verrà visualizzata la finestra specificata.
SetCookie(Uri, String)	Crea un cookie per il percorso specificato da 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)	Ricerca la risorsa specificata.
VerifyAccess()	Impone che il thread chiamante abbia accesso a DispatcherObject. (Ereditato da DispatcherObject)

Eventi

Activated	Si verifica quando un'applicazione diventa l'applicazione in primo piano.
Deactivated	Si verifica quando un'applicazione non è più l'applicazione in primo piano.
DispatcherUnhandledException	Si verifica quando un'eccezione viene generata da un'applicazione ma non viene gestita.
Exit	Si verifica appena prima dell'arresto di un'applicazione e non può essere annullata.
FragmentNavigation	Si verifica quando un navigatore nell'applicazione inizia lo spostamento a 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 è in contenuto diverso.
LoadCompleted	Si verifica quando il contenuto verso cui è stata effettuata la navigazione da uno strumento di navigazione nell'applicazione è stato caricato, analizzato o sottoposto a rendering.
Navigated	Si verifica quando il contenuto verso cui viene effettuata la navigazione da uno strumento di navigazione nell'applicazione è stato trovato, anche se il caricamento può non essere stato completato.
Navigating	Si verifica quando è richiesta una nuova navigazione da uno strumento di navigazione nell'applicazione.
NavigationFailed	Si verifica in caso di errore durante la navigazione di uno strumento di navigazione nell'applicazione sul contenuto richiesto.
NavigationProgress	Si verifica periodicamente durante un download gestito da uno strumento di navigazione nell'applicazione per fornire informazioni sullo stato di avanzamento della navigazione.
NavigationStopped	Si verifica quando viene chiamato il metodo `StopLoading` di uno strumento di navigazione nell'applicazione oppure quando viene richiesta una nuova navigazione da uno strumento di navigazione mentre la navigazione corrente è in corso.
SessionEnding	Si verifica quando l'utente termina la sessione di Windows mediante disconnessione o arresto del sistema operativo.
Startup	Si verifica quando viene chiamato il metodo Run() dell'oggetto Application.

Implementazioni dell'interfaccia esplicita

IQueryAmbient.IsAmbientPropertyAvailable(String)

Esegue una query per determinare se una proprietà di ambiente specificata è disponibile nell'ambito corrente.

Si applica a

Thread safety

I membri pubblici static (Shared in Visual Basic) di questo tipo sono thread safe. Inoltre, i metodi e e le FindResource(Object)Properties proprietà e Resources TryFindResource(Object) sono thread safe.

Vedi anche

Window

Condividi tramite