Specifies a set of values that are used when you start a process.
Assembly: System (in System.dll)
[<Sealed>] [<TypeConverterAttribute(typeof(ExpandableObjectConverter))>] [<PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")>] [<HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true, SelfAffectingProcessMgmt = true)>] type ProcessStartInfo = class end
Thetype exposes the following members.
|ProcessStartInfo()||Initializes a new instance of the class without specifying a file name with which to start the process.|
|ProcessStartInfo(String)||Initializes a new instance of the class and specifies a file name such as an application or document with which to start the process.|
|ProcessStartInfo(String, String)||Initializes a new instance of the class, specifies an application file name with which to start the process, and specifies a set of command-line arguments to pass to the application.|
|Arguments||Gets or sets the set of command-line arguments to use when starting the application.|
|CreateNoWindow||Gets or sets a value indicating whether to start the process in a new window.|
|Domain||Gets or sets a value that identifies the domain to use when starting the process.|
|EnvironmentVariables||Gets search paths for files, directories for temporary files, application-specific options, and other similar information.|
|ErrorDialog||Gets or sets a value indicating whether an error dialog box is displayed to the user if the process cannot be started.|
|ErrorDialogParentHandle||Gets or sets the window handle to use when an error dialog box is shown for a process that cannot be started.|
|FileName||Gets or sets the application or document to start.|
|LoadUserProfile||Gets or sets a value that indicates whether the Windows user profile is to be loaded from the registry.|
|Password||Gets or sets a secure string that contains the user password to use when starting the process.|
|RedirectStandardError||Gets or sets a value that indicates whether the error output of an application is written to the Process.StandardError stream.|
|RedirectStandardInput||Gets or sets a value indicating whether the input for an application is read from the Process.StandardInput stream.|
|RedirectStandardOutput||Gets or sets a value that indicates whether the output of an application is written to the Process.StandardOutput stream.|
|StandardErrorEncoding||Gets or sets the preferred encoding for error output.|
|StandardOutputEncoding||Gets or sets the preferred encoding for standard output.|
|UserName||Gets or sets the user name to be used when starting the process.|
|UseShellExecute||Gets or sets a value indicating whether to use the operating system shell to start the process.|
|Verb||Gets or sets the verb to use when opening the application or document specified by the FileName property.|
|Verbs||Gets the set of verbs associated with the type of file specified by the FileName property.|
|WindowStyle||Gets or sets the window state to use when the process is started.|
|WorkingDirectory||When the UseShellExecute property is false, gets or sets the working directory for the process to be started. When UseShellExecute is true, gets or sets the directory that contains the process to be started.|
|Equals(Object)||Determines whether the specified object is equal to the current object. (Inherited from Object.)|
|GetHashCode||Serves as the default hash function. (Inherited from Object.)|
|GetType||Gets the Type of the current instance. (Inherited from Object.)|
|ToString||Returns a string that represents the current object. (Inherited from Object.)|
is used together with the Process component. When you start a process using the Process class, you have access to process information in addition to that available when attaching to a running process.
You can use the class for better control over the process you start. You must at least set the FileName property, either manually or using the constructor. The file name is any application or document. Here a document is defined to be any file type that has an open or default action associated with it. You can view registered file types and their associated applications for your computer by using the Folder Options dialog box, which is available through the operating system. The Advanced button leads to a dialog box that shows whether there is an open action associated with a specific registered file type.
In addition, you can set other properties that define actions to take with that file. You can specify a value specific to the type of the FileName property for the Verb property. For example, you can specify "print" for a document type. Additionally, you can specify Arguments property values to be command-line arguments to pass to the file's open procedure. For example, if you specify a text editor application in the FileName property, you can use the Arguments property to specify a text file to be opened by the editor.
Standard input is usually the keyboard, and standard output and standard error are usually the monitor screen. However, you can use the RedirectStandardInput, RedirectStandardOutput, and RedirectStandardError properties to cause the process to get input from or return output to a file or other device. If you use the StandardInput, StandardOutput, or StandardError properties on the Process component, you must first set the corresponding value on the property. Otherwise, the system throws an exception when you read or write to the stream.
Set UseShellExecute to specify whether to start the process by using the operating system shell.
You can change the value of any property up to the time that the process starts. After you start the process, changing these values has no effect.
This class contains a link demand at the class level that applies to all members. A SecurityException is thrown when the immediate caller does not have full-trust permission. For details about security demands, see Link Demands.
The HostProtectionAttribute attribute applied to this type or member has the following Resources property value: SharedState | SelfAffectingProcessMgmt. The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes.