System.Environment.Exit Method

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

Syntax

public static void Exit (int exitCode)

Parameters

exitCode
Exit code to be given to the operating system. Use 0 (zero) to indicate that the process completed successfully.

Exceptions

TypeReason
System.Security.SecurityExceptionThe immediate caller does not have the required permission.

Remarks

For the exitCode parameter, use a non-zero number to indicate an error. In your application, you can define your own error codes in an enumeration, and return the appropriate error code based on the scenario. For example, return a value of 1 to indicate that the required file is not present and a value of 2 to indicate that the file is in the wrong format. For a list of exit codes used by the Windows operating system, see tp://msdn.microsoft.com/library/ms681381.aspx in the Windows documentation.

Calling the Environment.Exit(int) method differs from using your programming language's return statement in the following ways:

  • Environment.Exit(int) always terminates an application. Using the return statement may terminate an application only if it is used in the application entry point, such as in the Main method.

  • Environment.Exit(int) terminates an application immediately, even if other threads are running. If the return statement is called in the application entry point, it causes an application to terminate only after all foreground threads have terminated.

  • Environment.Exit(int) requires the caller to have permission to call unmanaged code. The return statement does not.

  • If Environment.Exit(int) is called from a try or finally block, the code in any catch block does not execute. If the return statement is used, the code in the catch block does execute.

Permissions

Requirements

Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0