Application Classe

Définition

Fournit des propriétés et des méthodes static pour gérer une application, comme des méthodes permettant de démarrer et d'arrêter une application et de traiter des messages Windows, et des propriétés permettant d'obtenir des informations sur une application.Provides static methods and properties to manage an application, such as methods to start and stop an application, to process Windows messages, and properties to get information about an application. Cette classe ne peut pas être héritée.This class cannot be inherited.

public ref class Application sealed
public sealed class Application
type Application = class
Public NotInheritable Class Application
Héritage
Application

Exemples

L’exemple de code suivant répertorie des nombres dans une zone de liste sur un formulaire.The following code example lists numbers in a list box on a form. Chaque fois que vous cliquez sur button1 , l’application ajoute un autre numéro à la liste.Each time you click button1, the application adds another number to the list.

La Main méthode appelle Run pour démarrer l’application, qui crée le formulaire listBox1 et button1 .The Main method calls Run to start the application, which creates the form, listBox1 and button1. Quand l’utilisateur clique sur button1 , la button1_Click méthode affiche un MessageBox .When the user clicks button1, the button1_Click method displays a MessageBox. Si l’utilisateur clique No sur le MessageBox , la button1_Click méthode ajoute un nombre à la liste.If the user clicks No on the MessageBox, the button1_Click method adds a number to the list. Si l’utilisateur clique sur Yes , l’application appelle Exit pour traiter tous les messages restants dans la file d’attente, puis pour quitter.If the user clicks Yes, the application calls Exit to process all remaining messages in the queue and then to quit.

Notes

L’appel à Exit échouera en mode de confiance partielle.The call to Exit will fail in partial trust.

public ref class Form1: public System::Windows::Forms::Form
{
private:
   Button^ button1;
   ListBox^ listBox1;

public:
   Form1()
   {
      button1 = gcnew Button;
      button1->Left = 200;
      button1->Text =  "Exit";
      button1->Click += gcnew EventHandler( this, &Form1::button1_Click );
      listBox1 = gcnew ListBox;
      this->Controls->Add( button1 );
      this->Controls->Add( listBox1 );
   }

private:
   void Form1::button1_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      int count = 1;
      
      // Check to see whether the user wants to exit 
      // the application. If not, add a number to the list box.
      while ( MessageBox::Show(  "Exit application?",  "", MessageBoxButtons::YesNo ) == ::DialogResult::No )
      {
         listBox1->Items->Add( count );
         count += 1;
      }

      
      // The user wants to exit the application. 
      // Close everything down.
      Application::Exit();
   }

};

int main()
{
   
   // Starts the application.
   Application::Run( gcnew Form1 );
}

public class Form1 : Form
{
    [STAThread]
    public static void Main()
    {
        // Start the application.
        Application.Run(new Form1());
    }

    private Button button1;
    private ListBox listBox1;

    public Form1()
    {
        button1 = new Button();
        button1.Left = 200;
        button1.Text = "Exit";
        button1.Click += new EventHandler(button1_Click);

        listBox1 = new ListBox();
        this.Controls.Add(button1);
        this.Controls.Add(listBox1);
    }

    private void button1_Click(object sender, System.EventArgs e)
    {
        int count = 1;
        // Check to see whether the user wants to exit the application.
        // If not, add a number to the list box.
        while (MessageBox.Show("Exit application?", "",
            MessageBoxButtons.YesNo)==DialogResult.No)
        {
            listBox1.Items.Add(count);
            count += 1;
        }

        // The user wants to exit the application.
        // Close everything down.
        Application.Exit();
    }
}
Public Class Form1 
    Inherits Form

    <STAThread()> _
     Shared Sub Main()
        ' Start the application.
        Application.Run(New Form1)
    End Sub

    Private WithEvents button1 As Button
    Private WithEvents listBox1 As ListBox

    Public Sub New()
        button1 = New Button
        button1.Left = 200
        button1.Text = "Exit"

        listBox1 = New ListBox
        Me.Controls.Add(button1)
        Me.Controls.Add(listBox1)
    End Sub

    Private Sub button1_Click(ByVal sender As Object, _
        ByVal e As System.EventArgs) Handles button1.Click
        Dim count As Integer = 1
        ' Check to see whether the user wants to exit the application.
        ' If not, add a number to the list box.
        While (MessageBox.Show("Exit application?", "", _
            MessageBoxButtons.YesNo) = DialogResult.No)

            listBox1.Items.Add(count)
            count += 1

        End While

        ' The user wants to exit the application. 
        ' Close everything down.
        Application.Exit()
    End Sub

End Class

Remarques

La Application classe a des méthodes pour démarrer et arrêter des applications et des threads, et pour traiter des messages Windows, comme suit :The Application class has methods to start and stop applications and threads, and to process Windows messages, as follows:

  • Run démarre une boucle de messages d’application sur le thread en cours et, éventuellement, rend un formulaire visible.Run starts an application message loop on the current thread and, optionally, makes a form visible.

  • Exit ou ExitThread arrête une boucle de message.Exit or ExitThread stops a message loop.

  • DoEvents traite les messages pendant que votre programme est en boucle.DoEvents processes messages while your program is in a loop.

  • AddMessageFilter Ajoute un filtre de message à la pompe de messages d’application pour analyser les messages Windows.AddMessageFilter adds a message filter to the application message pump to monitor Windows messages.

  • IMessageFilter vous permet d’arrêter le déclenchement d’un événement ou d’effectuer des opérations spéciales avant d’appeler un gestionnaire d’événements.IMessageFilter lets you stop an event from being raised or perform special operations before invoking an event handler.

Cette classe possède CurrentCulture des CurrentInputLanguage Propriétés et pour obtenir ou définir des informations de culture pour le thread actuel.This class has CurrentCulture and CurrentInputLanguage properties to get or set culture information for the current thread.

Vous ne pouvez pas créer une instance de cette classe.You cannot create an instance of this class.

Propriétés

AllowQuit

Obtient une valeur indiquant si l'appelant peut quitter cette application.Gets a value indicating whether the caller can quit this application.

CommonAppDataPath

Obtient le chemin des données d’application partagé par tous les utilisateurs.Gets the path for the application data that is shared among all users.

CommonAppDataRegistry

Obtient la clé de Registre des données d'application partagées entre tous les utilisateurs.Gets the registry key for the application data that is shared among all users.

CompanyName

Obtient le nom de la société associée à l'application.Gets the company name associated with the application.

CurrentCulture

Obtient ou définit les informations sur la culture du thread en cours.Gets or sets the culture information for the current thread.

CurrentInputLanguage

Obtient ou définit le langage d'entrée actuel du thread en cours.Gets or sets the current input language for the current thread.

ExecutablePath

Obtient le chemin d’accès au fichier exécutable ayant démarré l’application, y compris le nom de l’exécutable.Gets the path for the executable file that started the application, including the executable name.

HighDpiMode

Obtient le mode haute résolution actuel de l’application.Gets the current high DPI mode for the application.

LocalUserAppDataPath

Obtient le chemin d’accès aux données d’application d’un utilisateur local non itinérant.Gets the path for the application data of a local, non-roaming user.

MessageLoop

Obtient une valeur indiquant si une boucle de messages existe sur ce thread.Gets a value indicating whether a message loop exists on this thread.

OpenForms

Obtient une collection de formulaires ouverts possédée par l’application.Gets a collection of open forms owned by the application.

ProductName

Obtient le nom du produit associé à cette application.Gets the product name associated with this application.

ProductVersion

Obtient la version du produit associé à cette application.Gets the product version associated with this application.

RenderWithVisualStyles

Obtient une valeur qui spécifie si l'application actuelle dessine des contrôles avec des styles visuels.Gets a value specifying whether the current application is drawing controls with visual styles.

SafeTopLevelCaptionFormat

Obtient ou définit la chaîne de format à appliquer aux titres des fenêtres de niveau supérieur lorsqu'ils s'affichent avec une bannière d'avertissement.Gets or sets the format string to apply to top-level window captions when they are displayed with a warning banner.

StartupPath

Obtient le chemin d’accès au fichier exécutable ayant démarré l’application, sans le nom de l’exécutable.Gets the path for the executable file that started the application, not including the executable name.

UserAppDataPath

Obtient le chemin d’accès aux données d’application d’un utilisateur.Gets the path for the application data of a user.

UserAppDataRegistry

Obtient la clé de Registre pour les données d'application d'un utilisateur.Gets the registry key for the application data of a user.

UseVisualStyles

Obtient une valeur qui indique si les styles visuels sont activés pour l’application.Gets a value that indicates whether visual styles are enabled for the application.

UseWaitCursor

Obtient ou définit si le curseur d'attente est utilisé pour tous les formulaires ouverts de l'application.Gets or sets whether the wait cursor is used for all open forms of the application.

VisualStyleState

Obtient une valeur qui spécifie l'application de styles visuels aux fenêtres d'application.Gets a value that specifies how visual styles are applied to application windows.

Méthodes

AddMessageFilter(IMessageFilter)

Ajoute un filtre de messages permettant de surveiller les messages Windows lors de leur routage vers leur destination.Adds a message filter to monitor Windows messages as they are routed to their destinations.

DoEvents()

Traite tous les messages Windows présents dans la file d'attente de messages.Processes all Windows messages currently in the message queue.

EnableVisualStyles()

Active les styles visuels pour l'application.Enables visual styles for the application.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
Exit()

Informe toutes les pompes de messages qu'elles doivent se terminer, puis ferme toutes les fenêtres d'application une fois les messages traités.Informs all message pumps that they must terminate, and then closes all application windows after the messages have been processed.

Exit(CancelEventArgs)

Informe toutes les pompes de messages qu'elles doivent se terminer, puis ferme toutes les fenêtres d'application une fois les messages traités.Informs all message pumps that they must terminate, and then closes all application windows after the messages have been processed.

ExitThread()

Quitte la boucle de messages du thread en cours et ferme toutes les fenêtres du thread.Exits the message loop on the current thread and closes all windows on the thread.

FilterMessage(Message)

Applique tous les filtres à un message de fenêtre et retourne une copie du message modifié.Runs any filters against a window message, and returns a copy of the modified message.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OleRequired()

Initialise OLE sur le thread en cours.Initializes OLE on the current thread.

OnThreadException(Exception)

Déclenche l’événement ThreadException.Raises the ThreadException event.

RaiseIdle(EventArgs)

Déclenche l'événement Idle dans les scénarios hébergés.Raises the Idle event in hosted scenarios.

RegisterMessageLoop(Application+MessageLoopCallback)

Enregistre un rappel pour vérifier si la boucle de message s'exécute dans des environnements hébergés.Registers a callback for checking whether the message loop is running in hosted environments.

RemoveMessageFilter(IMessageFilter)

Enlève un filtre de messages de la pompe de messages de l'application.Removes a message filter from the message pump of the application.

Restart()

Ferme l'application et lance immédiatement une nouvelle instance.Shuts down the application and starts a new instance immediately.

Run()

Commence à exécuter une boucle de messages d'application standard sur le thread en cours, sans formulaire.Begins running a standard application message loop on the current thread, without a form.

Run(ApplicationContext)

Commence à exécuter une boucle de messages d'application standard sur le thread en cours, avec ApplicationContext.Begins running a standard application message loop on the current thread, with an ApplicationContext.

Run(Form)

Commence à exécuter une boucle de messages d'application standard sur le thread en cours et affiche le formulaire spécifié.Begins running a standard application message loop on the current thread, and makes the specified form visible.

SetCompatibleTextRenderingDefault(Boolean)

Définit la valeur par défaut à l’échelle de l’application destinée à la propriété UseCompatibleTextRendering définie sur certains contrôles.Sets the application-wide default for the UseCompatibleTextRendering property defined on certain controls.

SetHighDpiMode(HighDpiMode)

Définit le mode haute résolution du processus.Sets the high DPI mode of the process.

SetSuspendState(PowerState, Boolean, Boolean)

Suspend ou met en veille prolongée le système, ou demande que le système soit suspendu ou mis en veille prolongée.Suspends or hibernates the system, or requests that the system be suspended or hibernated.

SetUnhandledExceptionMode(UnhandledExceptionMode)

Indique à l'application comment répondre aux exceptions non gérées.Instructs the application how to respond to unhandled exceptions.

SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean)

Indique à l'application comment répondre aux exceptions non gérées, en appliquant éventuellement un comportement spécifique au thread.Instructs the application how to respond to unhandled exceptions, optionally applying thread-specific behavior.

ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)
UnregisterMessageLoop()

Annule l'enregistrement du rappel de boucle de message réalisé avec RegisterMessageLoop(Application+MessageLoopCallback).Unregisters the message loop callback made with RegisterMessageLoop(Application+MessageLoopCallback).

Événements

ApplicationExit

Se produit lorsque l'application est sur le point de s'arrêter.Occurs when the application is about to shut down.

EnterThreadModal

Se produit lorsque l'application est sur le point d'activer l'état modal.Occurs when the application is about to enter a modal state.

Idle

Se produit lorsque l'application termine le traitement et est sur le point de passer à l'état inactif.Occurs when the application finishes processing and is about to enter the idle state.

LeaveThreadModal

Se produit lorsque l'application est sur le point de quitter l'état modal.Occurs when the application is about to leave a modal state.

ThreadException

Se produit lorsqu'une exception de thread ininterrompu est levée.Occurs when an untrapped thread exception is thrown.

ThreadExit

Se produit lorsqu'un thread est sur le point de s'arrêter.Occurs when a thread is about to shut down. Lorsque le principal thread d'une application est sur le point de s'arrêter, cet événement commence par se déclencher, suivi d'un événement ApplicationExit.When the main thread for an application is about to be shut down, this event is raised first, followed by an ApplicationExit event.

S’applique à