This documentation is archived and is not being maintained.

Application.Restart Method

Note: This method is new in the .NET Framework version 2.0.

Shuts down the application and starts a new instance immediately.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in

public static void Restart ()
public static void Restart ()
public static function Restart ()

Exception typeCondition


Your code is not a Windows Forms application. You cannot call this method in this context.

The most common reason for calling Restart is to start a new version of the application that you have downloaded through ClickOnce using the Update or UpdateAsync method.

Applications are restarted in the context in which they were initially run. If your application was started using a URL pointing directly to the application's main executable file, it will be restarted using the same URL. If your application is a ClickOnce application, it will be restarted using ClickOnce.

If your application was originally supplied command-line options when it first executed, Restart will launch the application again with the same options.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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