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.

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

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

Environment.Exit(exitCode)
public static void Exit (
	int exitCode
)
public static function Exit (
	exitCode : int
)
Not applicable.

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.

' 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.

// 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 Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0
Show: