ProcessStartInfo ProcessStartInfo ProcessStartInfo ProcessStartInfo Class

Определение

Задает набор значений, используемых при запуске процесса.Specifies a set of values that are used when you start a process.

public ref class ProcessStartInfo sealed
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class ProcessStartInfo
type ProcessStartInfo = class
Public NotInheritable Class ProcessStartInfo
Наследование
ProcessStartInfoProcessStartInfoProcessStartInfoProcessStartInfo
Атрибуты

Примеры

В следующем примере кода демонстрируется использование ProcessStartInfo класса, чтобы запустить Internet Explorer, указав URL-адреса назначения как ProcessStartInfo аргументы.The following code example demonstrates how to use the ProcessStartInfo class to start Internet Explorer, providing the destination URLs as ProcessStartInfo arguments.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::ComponentModel;

// Opens the Internet Explorer application.
void OpenApplication(String^ myFavoritesPath)
{
    // Start Internet Explorer. Defaults to the home page.
    Process::Start("IExplore.exe");

    // Display the contents of the favorites folder in the browser.
    Process::Start(myFavoritesPath);
}

// Opens urls and .html documents using Internet Explorer.
void OpenWithArguments()
{
    // url's are not considered documents. They can only be opened
    // by passing them as arguments.
    Process::Start("IExplore.exe", "www.northwindtraders.com");

    // Start a Web page using a browser associated with .html and .asp files.
    Process::Start("IExplore.exe", "C:\\myPath\\myFile.htm");
    Process::Start("IExplore.exe", "C:\\myPath\\myFile.asp");
}

// Uses the ProcessStartInfo class to start new processes,
// both in a minimized mode.
void OpenWithStartInfo()
{
    ProcessStartInfo^ startInfo = gcnew ProcessStartInfo("IExplore.exe");
    startInfo->WindowStyle = ProcessWindowStyle::Minimized;
    Process::Start(startInfo);
    startInfo->Arguments = "www.northwindtraders.com";
    Process::Start(startInfo);
}

int main()
{
    // Get the path that stores favorite links.
    String^ myFavoritesPath = Environment::GetFolderPath(Environment::SpecialFolder::Favorites);
    OpenApplication(myFavoritesPath);
    OpenWithArguments();
    OpenWithStartInfo();
}
using System;
using System.Diagnostics;
using System.ComponentModel;

namespace MyProcessSample
{
    class MyProcess
    {
        // Opens the Internet Explorer application.
        void OpenApplication(string myFavoritesPath)
        {
            // Start Internet Explorer. Defaults to the home page.
            Process.Start("IExplore.exe");

            // Display the contents of the favorites folder in the browser.
            Process.Start(myFavoritesPath);
        }

        // Opens urls and .html documents using Internet Explorer.
        void OpenWithArguments()
        {
            // url's are not considered documents. They can only be opened
            // by passing them as arguments.
            Process.Start("IExplore.exe", "www.northwindtraders.com");

            // Start a Web page using a browser associated with .html and .asp files.
            Process.Start("IExplore.exe", "C:\\myPath\\myFile.htm");
            Process.Start("IExplore.exe", "C:\\myPath\\myFile.asp");
        }

        // Uses the ProcessStartInfo class to start new processes,
        // both in a minimized mode.
        void OpenWithStartInfo()
        {
            ProcessStartInfo startInfo = new ProcessStartInfo("IExplore.exe");
            startInfo.WindowStyle = ProcessWindowStyle.Minimized;

            Process.Start(startInfo);

            startInfo.Arguments = "www.northwindtraders.com";

            Process.Start(startInfo);
        }

        static void Main()
        {
            // Get the path that stores favorite links.
            string myFavoritesPath =
                Environment.GetFolderPath(Environment.SpecialFolder.Favorites);

            MyProcess myProcess = new MyProcess();

            myProcess.OpenApplication(myFavoritesPath);
            myProcess.OpenWithArguments();
            myProcess.OpenWithStartInfo();
        }
    }
}
Imports System.Diagnostics
Imports System.ComponentModel

Namespace MyProcessSample
    Class MyProcess
        ' Opens the Internet Explorer application.
        Public Sub OpenApplication(myFavoritesPath As String)
            ' Start Internet Explorer. Defaults to the home page.
            Process.Start("IExplore.exe")

            ' Display the contents of the favorites folder in the browser.
            Process.Start(myFavoritesPath)
        End Sub 'OpenApplication

        ' Opens urls and .html documents using Internet Explorer.
        Sub OpenWithArguments()
            ' url's are not considered documents. They can only be opened
            ' by passing them as arguments.
            Process.Start("IExplore.exe", "www.northwindtraders.com")

            ' Start a Web page using a browser associated with .html and .asp files.
            Process.Start("IExplore.exe", "C:\myPath\myFile.htm")
            Process.Start("IExplore.exe", "C:\myPath\myFile.asp")
        End Sub 'OpenWithArguments

        ' Uses the ProcessStartInfo class to start new processes,
        ' both in a minimized mode.
        Sub OpenWithStartInfo()
            Dim startInfo As New ProcessStartInfo("IExplore.exe")
            startInfo.WindowStyle = ProcessWindowStyle.Minimized

            Process.Start(startInfo)

            startInfo.Arguments = "www.northwindtraders.com"

            Process.Start(startInfo)
        End Sub 'OpenWithStartInfo

        Shared Sub Main()
            ' Get the path that stores favorite links.
            Dim myFavoritesPath As String = Environment.GetFolderPath(Environment.SpecialFolder.Favorites)

            Dim myProcess As New MyProcess()

            myProcess.OpenApplication(myFavoritesPath)
            myProcess.OpenWithArguments()
            myProcess.OpenWithStartInfo()
        End Sub 'Main
    End Class 'MyProcess
End Namespace 'MyProcessSample

Комментарии

ProcessStartInfo используется совместно с параметром Process компонента.ProcessStartInfo is used together with the Process component. При запуске процесса с помощью Process класс, у вас есть доступ для обработки информации, при присоединении к выполняющемуся процессу.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.

Можно использовать ProcessStartInfo класс для улучшения контроля над началом процесса.You can use the ProcessStartInfo class for better control over the process you start. Необходимо задать по крайней мере FileName свойства, либо вручную или с помощью конструктора.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. Можно указать значение, относящимся к типу FileName свойство для Verb свойство.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. Кроме того, можно указать Arguments значения свойств, которые быть аргументы командной строки для передачи процедуры открытия файла.Additionally, you can specify Arguments property values to be command-line arguments to pass to the file's open procedure. Например, если указать приложение текстового редактора в FileName свойство, можно использовать Arguments свойство, чтобы указать текстовый файл, открываемый в редакторе.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. Тем не менее, можно использовать RedirectStandardInput, RedirectStandardOutput, и RedirectStandardError свойства, чтобы процесс получения входных данных из или выходных данных в файл или другое устройство.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. Если вы используете StandardInput, StandardOutput, или StandardError свойства Process компонента, необходимо сначала задать соответствующее значение на ProcessStartInfo свойство.If you use the StandardInput, StandardOutput, or StandardError properties on the Process component, you must first set the corresponding value on the ProcessStartInfo property. В противном случае система создает исключение при чтении или записи в поток.Otherwise, the system throws an exception when you read or write to the stream.

Задайте UseShellExecute свойство, чтобы указать, следует ли запускать процесс с помощью оболочки операционной системы.Set the UseShellExecute property to specify whether to start the process by using the operating system shell. Если UseShellExecute присваивается false, новый процесс наследует стандартного потока ввода, стандартного вывода, и обработку стандартной ошибки потоков вызывающего объекта, если RedirectStandardInput, RedirectStandardOutput, или RedirectStandardError , соответственно, задано значение true.If UseShellExecute is set to false, the new process inherits the standard input, standard output, and standard error streams of the calling process, unless the RedirectStandardInput, RedirectStandardOutput, or RedirectStandardError properties, respectively, are set to true.

Можно изменить значения любого ProcessStartInfo свойство до момента запуска процесса.You can change the value of any ProcessStartInfo 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. Объект SecurityException возникает, если непосредственный вызывающий не имеет разрешения полного доверия.A SecurityException is thrown when the immediate caller does not have full-trust permission. Дополнительные сведения о требованиях безопасности см. в разделе требования связывания.For details about security demands, see Link Demands.

Конструкторы

ProcessStartInfo() ProcessStartInfo() ProcessStartInfo() ProcessStartInfo()

Инициализирует новый экземпляр класса ProcessStartInfo, не указывая имени файла, вместе с которым должен запускаться процесс.Initializes a new instance of the ProcessStartInfo class without specifying a file name with which to start the process.

ProcessStartInfo(String) ProcessStartInfo(String) ProcessStartInfo(String) ProcessStartInfo(String)

Инициализирует новый экземпляр класса ProcessStartInfo и задает имя файла, например приложение или документ, вместе с которым должен запускаться процесс.Initializes a new instance of the ProcessStartInfo class and specifies a file name such as an application or document with which to start the process.

ProcessStartInfo(String, String) ProcessStartInfo(String, String) ProcessStartInfo(String, String) ProcessStartInfo(String, String)

Инициализирует новый экземпляр класса ProcessStartInfo, задает имя файла приложения, вместе с которым должен запускаться процесс, и указывает передаваемые в приложение аргументы командной строки.Initializes a new instance of the ProcessStartInfo 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.

Свойства

ArgumentList ArgumentList ArgumentList ArgumentList

Возвращает коллекцию аргументов командной строки, используемых при запуске приложения.Gets a collection of command-line arguments to use when starting the application.

Arguments Arguments Arguments Arguments

Получает или задает набор аргументов командной строки, используемых при запуске приложения.Gets or sets the set of command-line arguments to use when starting the application.

CreateNoWindow CreateNoWindow CreateNoWindow CreateNoWindow

Получает или задает значение, позволяющее определить, нужно ли запускать процесс в новом окне.Gets or sets a value indicating whether to start the process in a new window.

Domain Domain Domain Domain

Получает или задает значение, позволяющее идентифицировать домен, используемый при запуске процесса.Gets or sets a value that identifies the domain to use when starting the process. Если это значение равно null, свойство UserName должно быть указано в формате имени субъекта-пользователя.If this value is null, the UserName property must be specified in UPN format.

Environment Environment Environment Environment

Возвращает переменные среды, относящиеся к этому процессу и его дочерним процессам.Gets the environment variables that apply to this process and its child processes.

EnvironmentVariables EnvironmentVariables EnvironmentVariables EnvironmentVariables

Получает пути поиска файлов, каталоги временных файлов, параметры данного приложения и другие аналогичные сведения.Gets search paths for files, directories for temporary files, application-specific options, and other similar information.

ErrorDialog ErrorDialog ErrorDialog ErrorDialog

Получает или задает значение, позволяющее определить, будет ли отображаться диалоговое окно сообщения об ошибке в случае невозможности запуска процесса.Gets or sets a value indicating whether an error dialog box is displayed to the user if the process cannot be started.

ErrorDialogParentHandle ErrorDialogParentHandle ErrorDialogParentHandle ErrorDialogParentHandle

Получает или задает дескриптор окна, используемый при отображении диалогового окна сообщения об ошибке в случае невозможности запустить процесс.Gets or sets the window handle to use when an error dialog box is shown for a process that cannot be started.

FileName FileName FileName FileName

Получает или задает приложение или документ для запуска.Gets or sets the application or document to start.

LoadUserProfile LoadUserProfile LoadUserProfile LoadUserProfile

Получает или задает значение, позволяющее определить, следует ли загружать профиль пользователя Windows из реестра.Gets or sets a value that indicates whether the Windows user profile is to be loaded from the registry.

Password Password Password Password

Получает или задает параметр безопасности, в котором содержится пароль пользователя, используемый при запуске процесса.Gets or sets a secure string that contains the user password to use when starting the process.

PasswordInClearText PasswordInClearText PasswordInClearText PasswordInClearText

Возвращает или задает пароль пользователя в виде открытого текста, который будет использоваться при запуске процесса.Gets or sets the user password in clear text to use when starting the process.

RedirectStandardError RedirectStandardError RedirectStandardError RedirectStandardError

Получает или задает значение, позволяющее определить, записываются ли выходные данные об ошибках приложения в поток StandardError.Gets or sets a value that indicates whether the error output of an application is written to the StandardError stream.

RedirectStandardInput RedirectStandardInput RedirectStandardInput RedirectStandardInput

Получает или задает значение, позволяющее определить, будут ли считываться входные данные приложения из потока StandardInput.Gets or sets a value indicating whether the input for an application is read from the StandardInput stream.

RedirectStandardOutput RedirectStandardOutput RedirectStandardOutput RedirectStandardOutput

Получает или задает значение, позволяющее определить, записываются ли текстовые выходные данные приложения в поток StandardOutput.Gets or sets a value that indicates whether the textual output of an application is written to the StandardOutput stream.

StandardErrorEncoding StandardErrorEncoding StandardErrorEncoding StandardErrorEncoding

Получает или задает предпочтительную кодировку для вывода ошибок.Gets or sets the preferred encoding for error output.

StandardInputEncoding StandardInputEncoding StandardInputEncoding StandardInputEncoding
StandardOutputEncoding StandardOutputEncoding StandardOutputEncoding StandardOutputEncoding

Получает или задает предпочтительную кодировку для стандартного вывода.Gets or sets the preferred encoding for standard output.

UserName UserName UserName UserName

Получает или задает имя пользователя, которое следует использовать при запуске процесса.Gets or sets the user name to use when starting the process. Если используется формат имени субъекта-пользователя, user @ DNS_domain_name, свойство Domain должно иметь значение null.If you use the UPN format, user@DNS_domain_name, the Domain property must be null.

UseShellExecute UseShellExecute UseShellExecute UseShellExecute

Получает или задает значение, позволяющее определить, нужно ли использовать оболочку операционной системы для запуска процесса.Gets or sets a value indicating whether to use the operating system shell to start the process.

Verb Verb Verb Verb

Получает или задает команду, которую необходимо использовать при открытии приложения или документа, указанного в свойстве FileName.Gets or sets the verb to use when opening the application or document specified by the FileName property.

Verbs Verbs Verbs Verbs

Получает набор команд, которые связаны с типом файла, заданным в свойстве FileName.Gets the set of verbs associated with the type of file specified by the FileName property.

WindowStyle WindowStyle WindowStyle WindowStyle

Получает или задает состояние окна, используемое при запуске процесса.Gets or sets the window state to use when the process is started.

WorkingDirectory WorkingDirectory WorkingDirectory WorkingDirectory

Если свойство UseShellExecute имеет значение false, возвращает или задает рабочую папку для запускаемого процесса.When the UseShellExecute property is false, gets or sets the working directory for the process to be started. Если параметру UseShellExecute присвоено значение true, возвращает или задает каталог, содержащий процесс, который требуется запустить.When UseShellExecute is true, gets or sets the directory that contains the process to be started.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Безопасность

SecurityPermission
для обращения к членам ProcessStartInfo.for calling members of ProcessStartInfo. Значение запроса: LinkDemand; [NIB: именованные наборы разрешений](https://msdn.microsoft.com/library/08250d67-c99d-4ab0-8d2b-b0e12019f6e3): FullTrust.Demand value: LinkDemand; [NIB: Named Permission Sets](https://msdn.microsoft.com/library/08250d67-c99d-4ab0-8d2b-b0e12019f6e3): FullTrust.

Применяется к

Дополнительно