ProcessStartInfo クラス

定義

プロセスを起動するときに使用する値のセットを指定します。Specifies a set of values that are used when you start a process.

public ref class ProcessStartInfo sealed
public sealed class ProcessStartInfo
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class ProcessStartInfo
type ProcessStartInfo = class
Public NotInheritable Class ProcessStartInfo
継承
ProcessStartInfo
属性

次のコード例では、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()
{
    // URLs 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

        ' Opens URLs and .html documents using Internet Explorer.
        Sub OpenWithArguments()
            ' URLs 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

        ' 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

        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
    End Class
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. Verb プロパティの FileName プロパティの型に固有の値を指定できます。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. ただし、RedirectStandardInputRedirectStandardOutput、および 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. Process コンポーネントで StandardInputStandardOutput、または StandardError プロパティを使用する場合は、最初に 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. UseShellExecutefalseに設定されている場合、新しいプロセスは、呼び出しプロセスの標準入力、標準出力、および標準エラーストリームを継承します。ただし、それぞれ RedirectStandardInputRedirectStandardOutput、または 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 クラスの新しいインスタンスを初期化します。Initializes a new instance of the ProcessStartInfo class without specifying a file name with which to start the process.

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 クラスの新しいインスタンスを初期化します。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

アプリケーションを起動するときに使用するコマンド ライン引数のコレクションを取得します。Gets a collection of command-line arguments to use when starting 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. この値が null の場合は、UserName プロパティを UPN 形式で指定する必要があります。If this value is null, the UserName property must be specified in UPN format.

Environment

このプロセスと子のプロセスに適用される環境変数を取得します。Gets the environment variables that apply to this process and its child processes.

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

Windows ユーザー プロファイルをレジストリから読み込むかどうかを示す値を取得または設定します。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.

PasswordInClearText

プロセスの開始時に使用する、クリア テキストのユーザーのパスワードを取得または設定します。Gets or sets the user password in clear text to use when starting the process.

RedirectStandardError

アプリケーションのエラー出力を StandardError ストリームに書き込むかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the error output of an application is written to the StandardError stream.

RedirectStandardInput

アプリケーションの入力を StandardInput ストリームから読み取るかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the input for an application is read from the StandardInput stream.

RedirectStandardOutput

アプリケーションのテキスト出力を StandardOutput ストリームに書き込むかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the textual output of an application is written to the StandardOutput stream.

StandardErrorEncoding

エラー出力に最適なエンコーディングを取得または設定します。Gets or sets the preferred encoding for error output.

StandardInputEncoding

標準入力に最適なエンコードを取得または設定します。Gets or sets the preferred encoding for standard input.

StandardOutputEncoding

標準出力に最適なエンコーディングを取得または設定します。Gets or sets the preferred encoding for standard output.

UserName

プロセスを開始するときに使用するユーザー名を取得または設定します。Gets or sets the user name to use when starting the process. UPN 形式 (user@DNS_domain_name) を使用する場合は、Domain プロパティを null に設定する必要があります。If you use the UPN format, user@DNS_domain_name, the Domain property must be null.

UseShellExecute

プロセスの起動にオペレーティング システムのシェルを使用するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether to use the operating system shell to start the process.

Verb

FileName プロパティで指定したアプリケーションまたはドキュメントを開くときに使用する動詞を取得または設定します。Gets or sets the verb to use when opening the application or document specified by the FileName property.

Verbs

FileName プロパティで指定したファイルの種類に関連付けられている動詞のセットを取得します。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

UseShellExecute プロパティが false の場合に、開始するプロセスの作業ディレクトリを取得または設定します。When the UseShellExecute property is false, gets or sets the working directory for the process to be started. UseShellExecutetrue の場合に、開始するプロセスを含むディレクトリを取得または設定します。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.

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)

適用対象

こちらもご覧ください