System.Diagnostics.Process.Start Method

Starts (or reuses) the process resource that is specified by the Process.StartInfo property of this System.Diagnostics.Process component and associates it with the component.

Syntax

public bool Start ()

Returns

true if a process resource is started; false if no new process resource is started (for example, if an existing process is reused).

Remarks

Use this overload to start a process resource and associate it with the current System.Diagnostics.Process component. The return value true indicates that a new process resource was started. If the process resource specified by the ProcessStartInfo.FileName member of the Process.StartInfo property is already running on the computer, no additional process resource is started. Instead, the running process resource is reused and false is returned.

You can start a ClickOnce application by specifying the location (for example, a Web address) from which you originally installed the application. Do not start a ClickOnce application by specifying its installed location on your hard drive.

Note:

If you are using Visual Studio, this overload of the Process.Start method is the one that you insert into your code after you drag a System.Diagnostics.Process component onto the designer. Use the Properties window to expand the StartInfo category and write the appropriate value into the FileName property. Your changes will appear in the form's InitializeComponent procedure.

This overload of Process.Start is not a static method. You must call it from an instance of the System.Diagnostics.Process class. Before calling Process.Start, you must first specify Process.StartInfo property information for this System.Diagnostics.Process instance, because that information is used to determine the process resource to start.

The other overloads of the Process.Start method are static members. You do not need to create an instance of the System.Diagnostics.Process component before you call those overloads of the method. Instead, you can call Process.Start for the System.Diagnostics.Process class itself, and a new System.Diagnostics.Process component is created if the process was started. Or, null is returned if a process was reused. The process resource is automatically associated with the new System.Diagnostics.Process component that is returned by the Process.Start method.

The Process.StartInfo members can be used to duplicate the functionality of the Run dialog box of the Windows Start menu. Anything that can be typed into a command line can be started by setting the appropriate values in the Process.StartInfo property. The only Process.StartInfo property that must be set is the ProcessStartInfo.FileName property. The ProcessStartInfo.FileName property does not have to be an executable file. It can be of any file type for which the extension has been associated with an application that is installed on the system. For example, the ProcessStartInfo.FileName property can have a .txt extension if you have associated text files with an editor, such as Notepad, or it can have a .doc extension if you have associated.doc files with a word processing tool, such as Microsoft Word.

In the command line, you can specify actions to take for certain types of files. For example, you can print documents or edit text files. Specify these actions using the ProcessStartInfo.Verb member of the Process.StartInfo property. For other types of files, you can specify command-line arguments when you start the file from the Run dialog box. For example, you can pass a URL as an argument if you specify your browser as the ProcessStartInfo.FileName. These arguments can be specified in the Process.StartInfo property's ProcessStartInfo.Arguments member.

If you have a path variable declared in your system using quotes, you must fully qualify that path when starting any process found in that location. Otherwise, the system will not find the path. For example, if c:\mypath is not in your path, and you add it using quotation marks: path = %path%;"c:\mypath", you must fully qualify any process in c:\mypath when starting it.

Note:

ASP.NET Web page and server control code executes in the context of the ASP.NET worker process on the Web server. If you use the erload:System.Diagnostics.Process.Start method in an ASP.NET Web page or server control, the new process executes on the Web server with restricted permissions. The process does not start in the same context as the client browser, and does not have access to the user desktop.

Whenever you use Process.Start to start a process, you might need to close it or you risk losing system resources. Close processes using Process.CloseMainWindow or Process.Kill.

A note about apartment states in managed threads is necessary here. When ProcessStartInfo.UseShellExecute is true on the process component's Process.StartInfo property, make sure you have set a threading model on your application by setting the attribute [STAThread] on the main() method. Otherwise, a managed thread can be in an unknown state or put in the MTA state, the latter of which conflicts with ProcessStartInfo.UseShellExecute being true. Some methods require that the apartment state not be unknown. If the state is not explicitly set, when the application encounters such a method, it defaults to MTA, and once set, the apartment state cannot be changed. However, MTA causes an exception to be thrown when the operating system shell is managing the thread.

Requirements

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