Click to Rate and Give Feedback
MSDN
MSDN Library
.NET Development
.NET Framework 2.0
System
Environment Class
Environment Methods
 Exit Method
Collapse All/Expand All Collapse All
.NET Framework Class Library
Environment.Exit Method

Terminates this process and gives the underlying operating system the specified exit code.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Visual Basic (Declaration)
Public Shared Sub Exit ( _
    exitCode As Integer _
)
Visual Basic (Usage)
Dim exitCode As Integer

Environment.Exit(exitCode)
C#
public static void Exit (
    int exitCode
)
C++
public:
static void Exit (
    int exitCode
)
J#
public static void Exit (
    int exitCode
)
JScript
public static function Exit (
    exitCode : int
)

Parameters

exitCode

Exit code to be given to the operating system.

Exception typeCondition

SecurityException

The caller does not have sufficient security permission to perform this function.

The following code example shows the use of the Exit method to terminate program execution and return an exit code to the operating system.

Visual Basic
' Example for the Environment.Exit( Integer ) method.
Imports System

Module ExitTest
   
    Sub Main()
        Console.WriteLine( _
            "If this program is invoked with [{0}] " & _
            "from the command prompt,", _
            Environment.CommandLine)
          
        Dim args As String() = Environment.GetCommandLineArgs()
          
        ' args[0] is the program name, and args[1] is the first argument.
        ' Test for a command-line argument.
        If args.Length > 1 Then

            ' Parse the argument. If successful, exit with the parsed code.
            Try
                Dim exitCode As Integer = Integer.Parse(args(1))
                
                Console.WriteLine("it exits with code: 0x{0:X8}.", exitCode)
                Environment.Exit(exitCode)

            ' If the parse fails, you fall out of the program.
            Catch 
            End Try
        End If
        Console.WriteLine("it exits by falling through.")
    End Sub 'Main
End Module 'ExitTest

' If this program is invoked with [EnvExit -2147480000] from the command prompt,
' it exits with code: 0x80000E40.
C#
// Example for the Environment.Exit( int ) method.
using System;

class ExitTest
{
    public static void Main( ) 
    {
        Console.WriteLine( 
            "If this program is invoked with [{0}] " +
            "from the command prompt,", 
            Environment.CommandLine );

        String[ ]   args = Environment.GetCommandLineArgs( );

        // args[0] is the program name and, args[1] is the first argument.
        // Test for a command-line argument.
        if( args.Length > 1 )
        {

            // Parse the argument. If successful, exit with the parsed code.
            try
            {
                int     exitCode = int.Parse( args[1] );

                Console.WriteLine( "it exits with code: 0x{0:X8}.", exitCode );
                Environment.Exit( exitCode );
            }
            // If the parse fails, you fall out of the program.
            catch
            { }
        }
        Console.WriteLine( "it exits by falling through." );
    }
}

/*
If this program is invoked with [EnvExit -2147480000] from the command prompt,
it exits with code: 0x80000E40.
*/
C++
// Example for the Environment::Exit( int ) method.
using namespace System;
int main()
{
   Console::WriteLine( "If this program is invoked with [{0}] "
   "from the command prompt,", Environment::CommandLine );
   array<String^>^args = Environment::GetCommandLineArgs();
   
   // args[0] is the program name, and args[1] is the first argument.
   // Test for a command-line argument.
   if ( args->Length > 1 )
   {
      
      // Parse the argument. If successful, exit with the parsed code.
      try
      {
         int exitCode = Int32::Parse( args[ 1 ] );
         Console::WriteLine( "it exits with code: 0x{0:X8}.", exitCode );
         Environment::Exit( exitCode );
      }
      // If the parse fails, you fall out of the program.
      catch ( Exception^ e ) 
      {
      }

   }

   Console::WriteLine( "it exits by falling through." );
}

/*
If this program is invoked with [EnvExit -2147480000] from the command prompt,
it exits with code: 0x80000E40.
*/
J#
// Example for the Environment.Exit(int) method.
import System.* ;

class ExitTest
{
    public static void main(String[] args)
    {
        Console.WriteLine("If this program is invoked with [{0}] " +
            "from the command prompt,", Environment.get_CommandLine());
        String args1[] = Environment.GetCommandLineArgs();

        // args[0] is the program name and, args[1] is the first argument.
        // Test for a command-line argument.
        if (args1.length > 1) {
            // Parse the argument. If successful, exit with the parsed code.
            try {
                int exitCode = Integer.parseInt(args1[1]);
                Console.WriteLine("it exits with code: 0x{0:X8}.",
                    ((System.Int32)(exitCode)).ToString("X8") );
                Environment.Exit(exitCode);
            }
            // If the parse fails, you fall out of the program.
            catch(System.Exception exp) {
            }
        }
        Console.WriteLine("it exits by falling through.");
    } //main
} //ExitTest

/*
If this program is invoked with [EnvExit -2147480000] from the command prompt,
it exits with code: 0x80000E40.
*/

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Processing
© 2012 Microsoft. All rights reserved. Terms of Use | Trademarks | Privacy Statement
Page view tracker