Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Exit Method

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:
© 2015 Microsoft