Application Classe

Definizione

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

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 StopLoading metodo di uno strumento di spostamento nell'applicazione o quando viene richiesta una nuova navigazione da uno strumento di spostamento mentre è in corso uno spostamento corrente.

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.

Vedi anche