This documentation is archived and is not being maintained.

Environment.Exit Method

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

[Visual Basic]
Public Shared Sub Exit( _
   ByVal exitCode As Integer _
)
[C#]
public static void Exit(
 int exitCode
);
[C++]
public: static void Exit(
 int exitCode
);
[JScript]
public static function Exit(
   exitCode : int
);

Parameters

exitCode
Exit code to be given to the operating system.

Exceptions

Exception Type Condition
SecurityException The caller does not have sufficient security permission to perform this function.

Example

[Visual Basic, C#, C++] 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 <mscorlib.dll>
using namespace System;

void main( ) 
{
    Console::WriteLine( 
        S"If this program is invoked with [{0}] " 
        S"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 = Int32::Parse( args[1] );

            Console::WriteLine( 
                S"it exits with code: 0x{0:X8}.", 
                __box(exitCode) );
            Environment::Exit( exitCode );
        }

        // If the parse fails, you fall out of the program.
        catch( Exception* e )
        { }
    }
    Console::WriteLine( S"it exits by falling through." );
}

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

[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, Common Language Infrastructure (CLI) Standard

.NET Framework Security: 

See Also

Environment Class | Environment Members | System Namespace

Show: