Application Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Encapsule une application 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
- Héritage
- Implémente
Exemples
L’exemple suivant montre comment une application standard est définie à l’aide du balisage uniquement :
<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" />
L’exemple suivant montre comment une application standard est définie à l’aide de code uniquement :
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
L’exemple suivant montre comment une application standard est définie à l’aide d’une combinaison de balisage et de 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
Remarques
Application est une classe qui encapsule les fonctionnalités propres à l’application WPF, notamment les suivantes :
Durée de vie de l’application : Activated, CurrentDeactivated, DispatcherUnhandledException, Exit, Run, SessionEndingShutdown, ShutdownMode, , . Startup
Fenêtre d’étendue d’application, propriété et gestion des ressources : FindResource, GetContentStream, GetResourceStream, LoadComponent, MainWindow, Properties, Resources, , StartupUri, Windows.
Paramètre de ligne de commande et traitement du code de sortie : Application.Startup, Application.Exit, Application.Shutdown.
Navigation : FragmentNavigation, LoadCompleted, Navigated, Navigating, NavigationProgress, NavigationStopped, NavigationFailed, SetCookie, GetCookie.
Application implémente le modèle singleton pour fournir un accès partagé à ses services de fenêtre, de propriété et d’étendue de ressources. Par conséquent, une seule instance de la Application classe peut être créée par AppDomain.
Vous pouvez implémenter un à l’aide du Application balisage, du balisage et du code-behind, ou du code. Si Application est implémenté avec le balisage, qu’il s’agisse d’un balisage ou d’un balisage et d’un code-behind, le fichier de balisage doit être configuré en tant qu’élément du moteur de build Microsoft (MSBuild). ApplicationDefinition
Notes
Une application autonome ne nécessite pas d’objet Application ; il est possible d’implémenter une méthode de point d’entrée personnalisée static
(Main
) qui ouvre une fenêtre sans créer d’instance de Application. Toutefois, les applications de navigateur XAML (XBAPs) nécessitent un Application objet .
Constructeurs
Application() |
Initialise une nouvelle instance de la classe Application. |
Propriétés
Current |
Obtient l'objet Application du AppDomain actuel. |
Dispatcher |
Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject) |
MainWindow |
Obtient ou définit la fenêtre principale de l'application. |
Properties |
Obtient une collection de propriétés de portée application. |
ResourceAssembly |
Obtient ou définit le Assembly qui fournit les identificateurs de ressources uniformes (URI) du pack pour les ressources d’une application WPF. |
Resources |
Obtient ou définit une collection de ressources de portée application, telles que des styles et des pinceaux. |
ShutdownMode |
Obtient ou définit la condition qui provoque l'appel de la méthode Shutdown(). |
StartupUri |
Obtient ou définit une interface utilisateur qui s'affiche automatiquement au démarrage d'une application. |
ThemeMode |
Encapsule une application Windows Presentation Foundation. |
Windows |
Obtient les fenêtres instanciées dans une application. |
Méthodes
CheckAccess() |
Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject) |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
FindResource(Object) |
Recherche une ressource d’interface utilisateur ( IU), telle qu’un Style ou Brush, avec la clé spécifiée, et lève une exception si la ressource demandée est introuvable (voir Ressources XAML). |
GetContentStream(Uri) |
Retourne un flux de ressources pour un fichier de données de contenu localisé au Uri spécifié (consultez Fichiers de ressources, de contenu et de données d’une application WPF). |
GetCookie(Uri) |
Récupère un cookie pour l'emplacement spécifié par un Uri. |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetRemoteStream(Uri) |
Retourne un flux de ressources pour un fichier de données du site d’origine localisé au Uri spécifié (consultez Fichiers de ressources, de contenu et de données d’une application WPF). |
GetResourceStream(Uri) |
Retourne un flux de ressources pour un fichier de données de ressources localisé au Uri spécifié (consultez Fichiers de ressources, de contenu et de données d’une application WPF). |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
LoadComponent(Object, Uri) |
Charge un fichier XAML qui se trouve à l’URI (Uniform Resource Identifier) spécifié et le convertit en une instance de l’objet spécifié par l’élément racine du fichier XAML. |
LoadComponent(Uri) |
Charge un fichier XAML situé à l’URI (Uniform Resource Identifier) spécifié et le convertit en une instance de l’objet spécifié par l’élément racine du fichier XAML. |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
OnActivated(EventArgs) |
Déclenche l’événement Activated. |
OnDeactivated(EventArgs) |
Déclenche l’événement Deactivated. |
OnExit(ExitEventArgs) |
Déclenche l’événement Exit. |
OnFragmentNavigation(FragmentNavigationEventArgs) |
Déclenche l’événement FragmentNavigation. |
OnLoadCompleted(NavigationEventArgs) |
Déclenche l’événement LoadCompleted. |
OnNavigated(NavigationEventArgs) |
Déclenche l’événement Navigated. |
OnNavigating(NavigatingCancelEventArgs) |
Déclenche l’événement Navigating. |
OnNavigationFailed(NavigationFailedEventArgs) |
Déclenche l’événement NavigationFailed. |
OnNavigationProgress(NavigationProgressEventArgs) |
Déclenche l’événement NavigationProgress. |
OnNavigationStopped(NavigationEventArgs) |
Déclenche l’événement NavigationStopped. |
OnSessionEnding(SessionEndingCancelEventArgs) |
Déclenche l’événement SessionEnding. |
OnStartup(StartupEventArgs) |
Déclenche l’événement Startup. |
Run() |
Démarre une application Windows Presentation Foundation. |
Run(Window) |
Démarre une application Windows Presentation Foundation et ouvre la fenêtre spécifiée. |
SetCookie(Uri, String) |
Crée un cookie pour l'emplacement spécifié par un Uri. |
Shutdown() |
Arrête une application. |
Shutdown(Int32) |
Ferme une application qui retourne le code de sortie spécifié au système d'exploitation. |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
TryFindResource(Object) |
Recherche la ressource spécifiée. |
VerifyAccess() |
Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject) |
Événements
Activated |
Se produit lorsqu'une application devient l'application de premier plan. |
Deactivated |
Se produit lorsqu'une application cesse d'être l'application de premier plan. |
DispatcherUnhandledException |
Se produit lorsqu'une exception est levée par une application mais non gérée. |
Exit |
Se produit juste avant l’arrêt d’une application et ne peut pas être annulé. |
FragmentNavigation |
Se produit lorsqu’un navigateur de l’application commence à naviguer vers un fragment de contenu, la navigation se produit immédiatement si le fragment souhaité se trouve dans le contenu actuel, ou après le chargement du contenu XAML source si le fragment souhaité se trouve dans un contenu différent. |
LoadCompleted |
Se produit lorsque le contenu cible de la navigation par un navigateur de l'application a été chargé et analysé et que son rendu a commencé. |
Navigated |
Se produit lorsque le contenu cible de la navigation par un navigateur de l'application a été trouvé, même s'il n'a peut-être pas pu être complètement chargé. |
Navigating |
Se produit lorsqu'une nouvelle navigation est demandée par un navigateur dans l'application. |
NavigationFailed |
Se produit lorsqu'une erreur survient tandis qu'un navigateur de l'application navigue jusqu'au contenu demandé. |
NavigationProgress |
Se produit périodiquement pendant un téléchargement géré par un navigateur dans l'application afin de fournir des informations sur la progression de la navigation. |
NavigationStopped |
Se produit lorsque la méthode |
SessionEnding |
Se produit quand l’utilisateur met fin à la session Windows en se déconnectant ou en arrêtant le système d’exploitation. |
Startup |
Se produit lorsque la méthode Run() de l'objet Application est appelée. |
Implémentations d’interfaces explicites
IQueryAmbient.IsAmbientPropertyAvailable(String) |
Demande si une propriété ambiante spécifiée est disponible dans la portée actuelle. |
S’applique à
Cohérence de thread
Les membres publics static
(Shared
en Visual Basic) de ce type sont thread-safe. En outre, les FindResource(Object) méthodes et TryFindResource(Object) et les Properties propriétés et Resources sont thread-safe.