Export (0) Print
Expand All

Application.Exit Method

Informs all message pumps that they must terminate, and then closes all application windows after the messages have been processed.

[Visual Basic]
Public Shared Sub Exit()
[C#]
public static void Exit();
[C++]
public: static void Exit();
[JScript]
public static function Exit();

Remarks

This method stops all running message loops on all threads and closes all windows of the application. This method does not force the application to exit. The Exit method is typically called from within a message loop, and forces Run to return. To exit a message loop for the current thread only, call ExitThread.

CAUTION   The Form.Closed and Form.Closing events are not raised when the Application.Exit method is called to exit your application. If you have validation code in either of these events that must be executed, you should call the Form.Close method for each open form individually before calling the Exit method.

Example

[Visual Basic, C#, C++] The following example lists numbers in a list box on a form. Each time you click button1, the application adds another number to the list.

[Visual Basic, C#, C++] The Main method calls Run to start the application, which creates the form, listBox1, and button1. When the user clicks button1, the button1_Click method adds numbers one to three to the list box, and displays a MessageBox. If the user clicks No on the MessageBox, the button1_Click method adds another number to the list. If the user clicks Yes, the application calls Exit, to process all remaining messages in the queue and then to quit.

[Visual Basic, C#, C++] The example assumes that listBox1 and button1 have been instantiated and placed on a form.

[Visual Basic] 
<STAThread()> _
Shared Sub Main()     
   ' Starts the application.
   Application.Run(New Form1())
End Sub

Sub button1_Click(sender As object, e As System.EventArgs)
   ' Populates a list box with three numbers.
   Dim i As Integer = 3
   Dim j As Integer
   For j = 1 To i - 1
      listBox1.Items.Add(j)
   Next

   ' Checks to see whether the user wants to exit the application.
   ' If not, adds another number to the list box.
   While (MessageBox.Show("Exit application?", "", MessageBoxButtons.YesNo) = _ 
      DialogResult.No)
      ' Increments the counter and adds the number to the list box.
      i = i + 1
      listBox1.Items.Add(i)
   End While

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


[C#] 
public static void Main(string[] args) {
    // Starts the application.
    Application.Run(new Form1());
 }
 
 protected void button1_Click(object sender, System.EventArgs e) {
    // Populates a list box with three numbers.
    int i = 3;
    for(int j=1; j<=i; j++) {
       listBox1.Items.Add(j);
    }
 
    /* Determines whether the user wants to exit the application.
     * If not, adds another number to the list box. */
    while (MessageBox.Show("Exit application?", "", MessageBoxButtons.YesNo) == 
       DialogResult.No) {
       // Increments the counter ands add the number to the list box.
       i++;
       listBox1.Items.Add(i);
    }
 
    // The user wants to exit the application. Close everything down.
    Application.Exit();
 }


[C++] 
public:
   static void main() {
      // Starts the application.
      Application::Run(new Form1());
   }

protected:
   void button1_Click(Object* sender, System::EventArgs* e) {
      // Populates a list box with three numbers.
      int i = 3;
      for (int j=1; j<=i; j++) {
         listBox1->Items->Add(__box(j));
      }

      /* Determines whether the user wants to exit the application.
      * If not, adds another number to the list box. */
      while (MessageBox::Show(S"Exit application?", S"", MessageBoxButtons::YesNo) ==
         DialogResult::No) {
            // Increments the counter ands add the number to the list box.
            i++;
            listBox1->Items->Add(__box(i));
         }

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

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

.NET Framework Security: 

See Also

Application Class | Application Members | System.Windows.Forms Namespace | ExitThread | Run

Show:
© 2014 Microsoft