Process.Start メソッド

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.Process.dll

プロセス リソースを起動し、Process コンポーネントに関連付けます。

オーバーロード

Start(String, String, String, SecureString, String)	アプリケーションの名前、コマンド ライン引数のセット、ユーザー名、パスワード、およびドメインを指定してプロセス リソースを起動し、リソースを新しい Process コンポーネントに関連付けます。
Start(String, String, SecureString, String)	アプリケーションの名前、ユーザー名、パスワード、ドメインを指定してプロセス リソースを起動し、リソースを新しい Process コンポーネントに関連付けます。
Start(String, String)	アプリケーションの名前とコマンド ライン引数のセットを指定してプロセス リソースを起動し、リソースを新しい Process コンポーネントに関連付けます。
Start(String)	文書またはアプリケーション ファイルの名前を指定してプロセス リソースを起動し、リソースを新しい Process コンポーネントに関連付けます。
Start(ProcessStartInfo)	プロセス起動情報 (起動するプロセスのファイル名など) が格納されているパラメーターで指定されたプロセス リソースを起動し、リソースを新しい Process コンポーネントに関連付けます。
Start()	この Process コンポーネントの StartInfo プロパティで指定されたプロセス リソースを起動 (または再利用) し、コンポーネントに関連付けます。
Start(String, IEnumerable<String>)	アプリケーションの名前とコマンド ライン引数のセットを指定してプロセス リソースを起動します。

Start(String, String, String, SecureString, String)

ソース:

Process.Unix.cs

重要

この API は CLS 準拠ではありません。

アプリケーションの名前、コマンド ライン引数のセット、ユーザー名、パスワード、およびドメインを指定してプロセス リソースを起動し、リソースを新しい Process コンポーネントに関連付けます。

public:
 static System::Diagnostics::Process ^ Start(System::String ^ fileName, System::String ^ arguments, System::String ^ userName, System::Security::SecureString ^ password, System::String ^ domain);

[System.CLSCompliant(false)]
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Diagnostics.Process? Start (string fileName, string arguments, string userName, System.Security.SecureString password, string domain);

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Start : string * string * string * System.Security.SecureString * string -> System.Diagnostics.Process

Public Shared Function Start (fileName As String, arguments As String, userName As String, password As SecureString, domain As String) As Process

パラメーター

fileName

String

プロセスで実行するアプリケーション ファイルの名前。

arguments

String

プロセスを起動するときに渡すコマンド ライン引数。

userName

String

プロセスの開始時に使用するユーザー名。

password

SecureString

プロセスを開始するときに使用するパスワードを含む SecureString。

domain

String

プロセスの開始時に使用するドメイン。

戻り値

Process

プロセス リソースに関連付けられている新しい Process。プロセス リソースが起動されていない場合は null。 同じプロセスのインスタンスが既に実行されているときに起動された新しいプロセスは、他のインスタンスから独立します。 また、Start では、HasExited プロパティが既に true に設定されている null 以外の Process が返される場合があります。 その場合、起動されたプロセス自体の既存のインスタンスがアクティブ化され、その後に終了されることがあります。

属性

CLSCompliantAttribute SupportedOSPlatformAttribute

例外

InvalidOperationException

ファイル名が指定されませんでした。

Win32Exception

関連付けられているファイルを開いているときにエラーが発生しました。

または

fileName で指定したファイルが見つかりませんでした。

または

引数の長さと関連ファイルへの完全パスの長さの合計が、2080 文字を超えています。 この例外に関連付けられているエラー メッセージは、"システム呼び出しに渡されるデータ領域が小さすぎます" または "アクセスが拒否されました" のいずれかです。

ObjectDisposedException

プロセス オブジェクトは既には破棄されています。

PlatformNotSupportedException

このメンバーは Linux または macOS (.NET Core のみ) ではサポートされていません。

注釈

このオーバーロードを使用して、ファイル名、コマンドライン引数、ユーザー名、パスワード、ドメインを指定して、新しいプロセスとそのプライマリ スレッドを作成します。 その後、新しいプロセスは、指定された資格情報 (ユーザー、ドメイン、パスワード) のセキュリティ コンテキストで、指定された実行可能ファイルを実行します。

重要

信頼されていないデータを指定してこのメソッドを呼び出すことは、セキュリティ上のリスクが伴います。 このメソッドは信頼されたデータでのみ呼び出してください。 詳細については、「 すべての入力を検証する」を参照してください。

注意

実行可能ファイルがリモート ドライブ上にある場合は、リンクされたドライブ文字ではなく、UNIFORM Resource Identifier (URI) を使用してネットワーク共有を識別する必要があります。

注意

開始する実行可能ファイルのアドレスが URL の場合、プロセスは開始されず、 null 返されます。

このオーバーロードを使用すると、最初に新しい Process インスタンスを作成せずにプロセスを開始できます。 オーバーロードは、新しいProcessインスタンスを作成し、プロパティの 、UserNameArguments、、Passwordおよび プロパティをFileName設定しDomain、インスタンスを呼び出すStartProcess明示的な手順のStartInfo代わりに使用します。

同様に、[ 実行 ] ダイアログ ボックスで、.exe 拡張子の有無にかかわらず実行可能ファイル名を受け入れるのと同じ方法で、.exe 拡張子はパラメーターで fileName 省略可能です。 たとえば、 パラメーターを fileName "Notepad.exe" または "メモ帳" に設定できます。 パラメーターが fileName 実行可能ファイルを表す場合、 arguments パラメーターは、 内のテキスト ファイルなど、処理するファイル Notepad.exe myfile.txtを表している可能性があります。

注意

ファイル名は、および パラメーターを持つuserNamepasswordオーバーロード内のStart実行可能ファイルをdomain表す必要があります。

を使用 Start してプロセスを開始するたびに、プロセスを閉じる必要があるか、システム リソースが失われるリスクがあります。 または Killを使用してプロセスをCloseMainWindow閉じます。 そのプロパティを使用してHasExited、プロセスが既に閉じられているかどうかをチェックできます。

Start(String, String, SecureString, String)

ソース:

Process.Unix.cs

重要

この API は CLS 準拠ではありません。

アプリケーションの名前、ユーザー名、パスワード、ドメインを指定してプロセス リソースを起動し、リソースを新しい Process コンポーネントに関連付けます。

public:
 static System::Diagnostics::Process ^ Start(System::String ^ fileName, System::String ^ userName, System::Security::SecureString ^ password, System::String ^ domain);

[System.CLSCompliant(false)]
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Diagnostics.Process? Start (string fileName, string userName, System.Security.SecureString password, string domain);

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Start : string * string * System.Security.SecureString * string -> System.Diagnostics.Process

Public Shared Function Start (fileName As String, userName As String, password As SecureString, domain As String) As Process

パラメーター

fileName

String

プロセスで実行するアプリケーション ファイルの名前。

userName

String

プロセスの開始時に使用するユーザー名。

password

SecureString

プロセスを開始するときに使用するパスワードを含む SecureString。

domain

String

プロセスの開始時に使用するドメイン。

戻り値

Process

プロセス リソースに関連付けられている新しい Process。プロセス リソースが起動されていない場合は null。 同じプロセスのインスタンスが既に実行されているときに起動された新しいプロセスは、他のインスタンスから独立します。 また、Start では、HasExited プロパティが既に true に設定されている null 以外の Process が返される場合があります。 その場合、起動されたプロセス自体の既存のインスタンスがアクティブ化され、その後に終了されることがあります。

属性

CLSCompliantAttribute SupportedOSPlatformAttribute

例外

InvalidOperationException

ファイル名が指定されませんでした。

Win32Exception

関連付けられているファイルを開いているときにエラーが発生しました。

または

fileName で指定したファイルが見つかりませんでした。

ObjectDisposedException

プロセス オブジェクトは既には破棄されています。

PlatformNotSupportedException

このメンバーは Linux または macOS (.NET Core のみ) ではサポートされていません。

例

次のコード例では、このオーバーロードを使用して実行可能ファイルを起動し、実行不可能なファイルに関連付けられているアプリケーションを起動しようとした場合の Win32Exception のスローも示しています。

// NOTE: This example requires a text.txt file file in your Documents folder
using System;
using System.Diagnostics;
using System.Security;
using System.ComponentModel;

class Example
{
    static void Main()
    {
        Console.Write("Enter your domain: ");
        string domain = Console.ReadLine();
        Console.Write("Enter you user name: ");
        string uname = Console.ReadLine();
        Console.Write("Enter your password: ");
        SecureString password = new SecureString();
        ConsoleKeyInfo key;
        do
        {
            key = Console.ReadKey(true);

            // Ignore any key out of range.
            if (((int)key.Key) >= 33 && ((int)key.Key <= 90) && key.Key != ConsoleKey.Enter)
            {
                // Append the character to the password.
                password.AppendChar(key.KeyChar);
                Console.Write("*");
            }
            // Exit if Enter key is pressed.
        } while (key.Key != ConsoleKey.Enter);
        Console.WriteLine();

        try
        {
            Console.WriteLine("\nTrying to launch NotePad using your login information...");
            Process.Start("notepad.exe", uname, password, domain);
        }
        catch (Win32Exception ex)
        {
            Console.WriteLine(ex.Message);
        }

        string path = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments) + "\\";

        try
        {
            // The following call to Start succeeds if test.txt exists.
            Console.WriteLine("\nTrying to launch 'text.txt'...");
            Process.Start(path + "text.txt");
        }
        catch (Win32Exception ex)
        {
            Console.WriteLine(ex.Message);
        }

        try
        {
            // Attempting to start in a shell using this Start overload fails. This causes
            // the following exception, which is picked up in the catch block below:
            // The specified executable is not a valid application for this OS platform.
            Console.WriteLine("\nTrying to launch 'text.txt' with your login information...");
            Process.Start(path + "text.txt", uname, password, domain);
        }
        catch (Win32Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        finally
        {
            password.Dispose();
        }
    }
}

' This sample requires a text.txt file file in your documents folder.
' You'll also need to set the startup object in the project to Sub Main.
Imports System.Diagnostics
Imports System.Security
Imports System.ComponentModel

Module Program
    Sub Main()
        Console.Write("Enter your domain: ")
        Dim domain As String = Console.ReadLine()
        Console.Write("Enter you user name: ")
        Dim uname As String = Console.ReadLine()
        Console.Write("Enter your password: ")
        Dim password As New SecureString()
        Dim key As ConsoleKeyInfo
        Do
            key = Console.ReadKey(True)

            ' Ignore any key out of range.
            If key.Key >= 33 AndAlso key.Key <= 90 AndAlso key.Key <> ConsoleKey.Enter Then
                ' Append the character to the password.
                password.AppendChar(key.KeyChar)
                Console.Write("*")
            End If
            ' Exit if Enter key is pressed.
        Loop While key.Key <> ConsoleKey.Enter
        Console.WriteLine()

        Try
            Console.WriteLine(vbCrLf + "Trying to launch NotePad using your login information...")
            Process.Start("notepad.exe", uname, password, domain)
        Catch ex As Win32Exception
            Console.WriteLine(ex.Message)
        End Try

        Dim path As String = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments) + "\"

        Try
            ' The following call to Start succeeds if test.txt exists.
            Console.WriteLine(vbCrLf + "Trying to launch 'text.txt'...")
            Process.Start(path + "Text.txt")
        Catch ex As Win32Exception
            Console.WriteLine(ex.Message)
        End Try

        Try
            ' Attempting to start in a shell using this Start overload fails. This causes
            ' the following exception, which is picked up in the catch block below:
            ' The specified executable is not a valid application for this OS platform.
            Console.WriteLine(vbCrLf + "Trying to launch 'text.txt' with your login information...")
            Process.Start(path + "Text.txt", uname, password, domain)
        Catch ex As Win32Exception
            Console.WriteLine(ex.Message)
        Finally
            password.Dispose()
        End Try
    End Sub
End Module

注釈

このオーバーロードを使用して、ファイル名、ユーザー名、パスワード、ドメインを指定して、新しいプロセスとそのプライマリ スレッドを作成します。 その後、新しいプロセスは、指定された資格情報 (ユーザー、ドメイン、パスワード) のセキュリティ コンテキストで、指定された実行可能ファイルを実行します。

重要

信頼されていないデータを指定してこのメソッドを呼び出すことは、セキュリティ上のリスクが伴います。 このメソッドは信頼されたデータでのみ呼び出してください。 詳細については、「 すべての入力を検証する」を参照してください。

注意

実行可能ファイルがリモート ドライブ上にある場合は、リンクされたドライブ文字ではなく、UNIFORM Resource Identifier (URI) を使用してネットワーク共有を識別する必要があります。

注意

開始する実行可能ファイルのアドレスが URL の場合、プロセスは開始されず、 null 返されます。

このオーバーロードを使用すると、最初に新しい Process インスタンスを作成せずにプロセスを開始できます。 オーバーロードは、新しいProcessインスタンスを作成し、プロパティの 、UserName、Passwordおよび プロパティStartInfoを設定しDomain、インスタンスをFileName呼び出すStartProcess明示的な手順の代わりに使用されます。

同様に、[ 実行 ] ダイアログ ボックスで、.exe 拡張子の有無にかかわらず実行可能ファイル名を受け入れるのと同じ方法で、.exe 拡張子はパラメーターで fileName 省略可能です。 たとえば、 パラメーターを fileName "Notepad.exe" または "メモ帳" に設定できます。 パラメーターが fileName 実行可能ファイルを表す場合、 arguments パラメーターは、 内のテキスト ファイルなど、処理するファイル Notepad.exe myfile.txtを表している可能性があります。

注意

ファイル名は、および パラメーターを持つuserNamepasswordオーバーロード内のStart実行可能ファイルをdomain表す必要があります。

を使用 Start してプロセスを開始するたびに、プロセスを閉じる必要があるか、システム リソースが失われるリスクがあります。 または Killを使用してプロセスをCloseMainWindow閉じます。 そのプロパティを使用してHasExited、プロセスが既に閉じられているかどうかをチェックできます。

Start(String, String)

ソース:

Process.cs

アプリケーションの名前とコマンド ライン引数のセットを指定してプロセス リソースを起動し、リソースを新しい Process コンポーネントに関連付けます。

public:
 static System::Diagnostics::Process ^ Start(System::String ^ fileName, System::String ^ arguments);

[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
[System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")]
public static System.Diagnostics.Process Start (string fileName, string arguments);

[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
[<System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")>]
static member Start : string * string -> System.Diagnostics.Process

Public Shared Function Start (fileName As String, arguments As String) As Process

パラメーター

fileName

String

プロセスで実行するアプリケーション ファイルの名前。

arguments

String

プロセスを起動するときに渡すコマンド ライン引数。

戻り値

Process

プロセス リソースに関連付けられている新しい Process。プロセス リソースが起動されていない場合は null。 同じプロセスのインスタンスが既に実行されているときに起動された新しいプロセスは、他のインスタンスから独立します。 また、Start では、HasExited プロパティが既に true に設定されている null 以外の Process が返される場合があります。 その場合、起動されたプロセス自体の既存のインスタンスがアクティブ化され、その後に終了されることがあります。

属性

UnsupportedOSPlatformAttribute SupportedOSPlatformAttribute

例外

InvalidOperationException

fileName パラメーターまたは arguments パラメーターが null です。

Win32Exception

関連付けられているファイルを開いているときにエラーが発生しました。

または

fileName で指定したファイルが見つかりませんでした。

または

引数の長さとプロセスへの完全パスの長さの合計が、2080 文字を超えています。 この例外に関連付けられているエラー メッセージは、"システム呼び出しに渡されるデータ領域が小さすぎます" または "アクセスが拒否されました" のいずれかです。

ObjectDisposedException

プロセス オブジェクトは既には破棄されています。

FileNotFoundException

PATH 環境変数に、引用符を含む文字列があります。

例

次の例では、最初にインターネット エクスプローラーのインスタンスを生成し、ブラウザーに [お気に入り] フォルダーの内容を表示します。 次に、インターネット エクスプローラーの他のインスタンスを開始し、特定のページまたはサイトを表示します。 最後に、特定のサイトに移動中にウィンドウが最小化された状態でインターネット エクスプローラーを開始します。

#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

注釈

このオーバーロードを使用して、ファイル名とコマンド ライン引数を指定してプロセス リソースを開始します。 オーバーロードは、リソースを新 Process しいオブジェクトに関連付けます。

重要

信頼されていないデータを指定してこのメソッドを呼び出すことは、セキュリティ上のリスクが伴います。 このメソッドは信頼されたデータでのみ呼び出してください。 詳細については、「 すべての入力を検証する」を参照してください。

注意

開始する実行可能ファイルのアドレスが URL の場合、プロセスは開始されず、 null 返されます。

このオーバーロードを使用すると、最初に新しい Process インスタンスを作成せずにプロセスを開始できます。 オーバーロードは、新しいProcessインスタンスを作成し、 プロパティの メンバーと Arguments メンバーStartInfoを設定FileNameし、 インスタンスを呼び出すStartProcess明示的な手順の代わりに使用します。

ファイル名と引数を指定してプロセスを開始することは、Windows Start メニューのダイアログ ボックスにファイル名とコマンド ライン引数をRun入力するのと似ています。 したがって、ファイル名は実行可能ファイルを表す必要はありません。 拡張子がシステムにインストールされているアプリケーションに関連付けられている任意の種類のファイルにすることができます。 たとえば、メモ帳などのエディターにテキスト ファイルが関連付けられている場合は、ファイル名に .txt 拡張子を付けたり、.doc ファイルを Microsoft Word などのワープロ ツールに関連付けた場合は .doc を持つことができます。 同様に、ダイアログ ボックスで、.exe 拡張子の有無にかかわらず実行可能ファイル名を受け入れるのと同じ方法 Run で、.exe 拡張子は パラメーターで fileName 省略可能です。 たとえば、 パラメーターを fileName "Notepad.exe" または "メモ帳" に設定できます。 パラメーターが fileName 実行可能ファイルを表す場合、 arguments パラメーターは、 内のテキスト ファイルなど、処理するファイル Notepad.exe myfile.txtを表している可能性があります。 パラメーターが fileName コマンド (.cmd) ファイルを表す場合、コマンド ウィンドウが終了するか、 arguments 完了後も残るかを指定するには、パラメーターに "/c" または "/k" 引数を含める必要があります。

他のオーバーロードとは異なり、パラメーターを持たない の Start オーバーロードはメンバーではありません static 。 インスタンスを既に作成 Process し、開始情報 (ファイル名を含む) を指定し、プロセス リソースを開始して既存 Process のインスタンスに関連付ける場合は、そのオーバーロードを使用します。 既存のコンポーネントのプロセスを static 開始するのではなく、新しい Process コンポーネントを作成する場合は、いずれかのオーバーロードを使用します。 このオーバーロードとパラメーターを持たないオーバーロードの両方で、開始するプロセス リソースのファイル名と渡すコマンド ライン引数を指定できます。

システムでパス変数を引用符で囲んで宣言している場合、その場所で見つかるプロセスを開始するときに、そのパスを完全修飾する必要があります。 そうしないと、システムはそのパスを見つけられません。 たとえば、c:\mypath がパスに含まれておらず、それを path = %path%;"c:\mypath"` のように引用符を使用して追加した場合、c:\mypath 内の任意のプロセスを開始するときに、それを完全修飾する必要があります。

注意

ASP.NET Web ページとサーバー コントロール コードは、Web サーバー上の ASP.NET ワーカー プロセスのコンテキストで実行されます。 ASP.NET Web ページまたはサーバー コントロールで メソッドを使用 Start すると、アクセス許可が制限された Web サーバー上で新しいプロセスが実行されます。 プロセスはクライアント ブラウザーと同じコンテキストで開始されず、ユーザー デスクトップにアクセスできません。

を使用 Start してプロセスを開始するたびに、プロセスを閉じる必要があるか、システム リソースが失われるリスクがあります。 または Killを使用してプロセスをCloseMainWindow閉じます。 そのプロパティを使用してHasExited、プロセスが既に閉じられているかどうかをチェックできます。

ここでは、マネージド スレッドのアパートメントの状態に関する注意が必要です。 UseShellExecuteがtrueプロセス コンポーネントの StartInfo プロパティにある場合は、 メソッドに 属性[STAThread]を設定して、アプリケーションにスレッド モデルをmain()設定していることを確認します。 それ以外の場合は、マネージド スレッドをunknown状態にするか、状態にMTA置くことができます。後者は とtrue競合しますUseShellExecute。 一部のメソッドでは、アパートメントの状態が である必要はありません unknown。 状態が明示的に設定されていない場合、アプリケーションでこのようなメソッドが検出されると、既定値 MTAは に設定され、一度設定されると、アパートメントの状態を変更することはできません。 ただし、 MTA オペレーティング システム シェルがスレッドを管理しているときに例外がスローされます。

こちらもご覧ください

• FileName
• StartInfo
• ProcessStartInfo
• CloseMainWindow()
• Kill()

Start(String)

ソース:

Process.cs

文書またはアプリケーション ファイルの名前を指定してプロセス リソースを起動し、リソースを新しい Process コンポーネントに関連付けます。

public:
 static System::Diagnostics::Process ^ Start(System::String ^ fileName);

[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
[System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")]
public static System.Diagnostics.Process Start (string fileName);

[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
[<System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")>]
static member Start : string -> System.Diagnostics.Process

Public Shared Function Start (fileName As String) As Process

パラメーター

fileName

String

プロセスで実行する文書またはアプリケーション ファイルの名前。

戻り値

Process

プロセス リソースに関連付けられている新しい Process。プロセス リソースが起動されていない場合は null。 同じプロセスのインスタンスが既に実行されているときに起動された新しいプロセスは、他のインスタンスから独立します。 また、Start では、HasExited プロパティが既に true に設定されている null 以外の Process が返される場合があります。 その場合、起動されたプロセス自体の既存のインスタンスがアクティブ化され、その後に終了されることがあります。

属性

UnsupportedOSPlatformAttribute SupportedOSPlatformAttribute

例外

Win32Exception

関連付けられているファイルを開いているときにエラーが発生しました。

または

fileName で指定したファイルが見つかりませんでした。

ObjectDisposedException

プロセス オブジェクトは既には破棄されています。

FileNotFoundException

PATH 環境変数に、引用符を含む文字列があります。

例

次の例では、最初にインターネット エクスプローラーのインスタンスを生成し、ブラウザーに [お気に入り] フォルダーの内容を表示します。 次に、インターネット エクスプローラーの他のインスタンスを開始し、特定のページまたはサイトを表示します。 最後に、特定のサイトに移動中にウィンドウが最小化された状態でインターネット エクスプローラーを開始します。

#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

注釈

このオーバーロードを使用して、ファイル名を指定してプロセス リソースを開始します。 オーバーロードは、リソースを新 Process しいオブジェクトに関連付けます。

重要

信頼されていないデータを指定してこのメソッドを呼び出すことは、セキュリティ上のリスクが伴います。 このメソッドは信頼されたデータでのみ呼び出してください。 詳細については、「 すべての入力を検証する」を参照してください。

注意

開始する実行可能ファイルのアドレスが URL の場合、プロセスは開始されず、 null 返されます。

このオーバーロードを使用すると、最初に新しい Process インスタンスを作成せずにプロセスを開始できます。 オーバーロードは、新しいProcessインスタンスの作成、プロパティのメンバーの設定FileName、インスタンスの呼び出StartしのStartInfo明示的な手順に代わるProcess方法です。

ClickOnce アプリケーションを起動するには、 パラメーターを fileName 、アプリケーションを最初にインストールした場所 (Web アドレスなど) に設定します。 ハード ドライブにインストールされている場所を指定して ClickOnce アプリケーションを起動しないでください。

ファイル名を指定してプロセスを開始することは、Windows Start メニューのダイアログ ボックスに情報をRun入力するのと似ています。 したがって、ファイル名は実行可能ファイルを表す必要はありません。 拡張子がシステムにインストールされているアプリケーションに関連付けられている任意の種類のファイルにすることができます。 たとえば、メモ帳などのエディターにテキスト ファイルが関連付けられている場合は、ファイル名に .txt 拡張子を付けたり、.doc ファイルを Microsoft Word などのワープロ ツールに関連付けた場合は .doc を持つことができます。 同様に、ダイアログ ボックスで、.exe 拡張子の有無にかかわらず実行可能ファイル名を受け入れるのと同じ方法 Run で、.exe 拡張子は パラメーターで fileName 省略可能です。 たとえば、 パラメーターを fileName "Notepad.exe" または "メモ帳" に設定できます。

このオーバーロードでは、プロセスのコマンド ライン引数は使用できません。 プロセスに 1 つ以上のコマンド ライン引数を指定する必要がある場合は、 または Process.Start(String, String) オーバーロードをProcess.Start(ProcessStartInfo)使用します。

他のオーバーロードとは異なり、パラメーターを持たない の Start オーバーロードはメンバーではありません static 。 インスタンスを既に作成 Process し、開始情報 (ファイル名を含む) を指定し、プロセス リソースを開始して既存 Process のインスタンスに関連付ける場合は、そのオーバーロードを使用します。 既存のコンポーネントのプロセスを static 開始するのではなく、新しい Process コンポーネントを作成する場合は、いずれかのオーバーロードを使用します。 このオーバーロードとパラメーターを持たないオーバーロードの両方で、開始するプロセス リソースのファイル名を指定できます。

システムでパス変数を引用符で囲んで宣言している場合、その場所で見つかるプロセスを開始するときに、そのパスを完全修飾する必要があります。 そうしないと、システムはそのパスを見つけられません。 たとえば、c:\mypath がパスに含まれておらず、それを path = %path%;"c:\mypath"` のように引用符を使用して追加した場合、c:\mypath 内の任意のプロセスを開始するときに、それを完全修飾する必要があります。

注意

ASP.NET Web ページとサーバー コントロール コードは、Web サーバー上の ASP.NET ワーカー プロセスのコンテキストで実行されます。 ASP.NET Web ページまたはサーバー コントロールで メソッドを使用 Start すると、アクセス許可が制限された Web サーバー上で新しいプロセスが実行されます。 プロセスはクライアント ブラウザーと同じコンテキストで開始されず、ユーザー デスクトップにアクセスできません。

を使用 Start してプロセスを開始するたびに、プロセスを閉じる必要があるか、システム リソースが失われるリスクがあります。 または Killを使用してプロセスをCloseMainWindow閉じます。 そのプロパティを使用してHasExited、プロセスが既に閉じられているかどうかをチェックできます。

ここでは、マネージド スレッドのアパートメントの状態に関する注意が必要です。 UseShellExecuteがtrueプロセス コンポーネントの StartInfo プロパティにある場合は、 メソッドに 属性[STAThread]を設定して、アプリケーションにスレッド モデルをmain()設定していることを確認します。 それ以外の場合は、マネージド スレッドを unknown 状態にするか、状態にMTA置くことができます。後者は とtrue競合しますUseShellExecute。 一部のメソッドでは、アパートメントの状態が である unknown必要はありません。 状態が明示的に設定されていない場合、アプリケーションでこのようなメソッドが検出されると、既定値は に MTA設定され、一度設定されると、アパートメントの状態を変更することはできません。 ただし、 MTA オペレーティング システム シェルがスレッドを管理しているときに例外がスローされます。

こちらもご覧ください

• FileName
• StartInfo
• CloseMainWindow()
• Kill()

Start(ProcessStartInfo)

ソース:

Process.cs

プロセス起動情報 (起動するプロセスのファイル名など) が格納されているパラメーターで指定されたプロセス リソースを起動し、リソースを新しい Process コンポーネントに関連付けます。

public:
 static System::Diagnostics::Process ^ Start(System::Diagnostics::ProcessStartInfo ^ startInfo);

[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
[System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")]
public static System.Diagnostics.Process? Start (System.Diagnostics.ProcessStartInfo startInfo);

[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
[<System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")>]
static member Start : System.Diagnostics.ProcessStartInfo -> System.Diagnostics.Process

Public Shared Function Start (startInfo As ProcessStartInfo) As Process

パラメーター

startInfo

ProcessStartInfo

ファイル名やコマンド ライン引数など、プロセスの起動に使用する情報が格納されている ProcessStartInfo。

戻り値

Process

プロセス リソースに関連付けられている新しい Process。プロセス リソースが起動されていない場合は null。 同じプロセスのインスタンスが既に実行されているときに起動された新しいプロセスは、他のインスタンスから独立します。 また、Start では、HasExited プロパティが既に true に設定されている null 以外の Process が返される場合があります。 その場合、起動されたプロセス自体の既存のインスタンスがアクティブ化され、その後に終了されることがあります。

属性

UnsupportedOSPlatformAttribute SupportedOSPlatformAttribute

例外

InvalidOperationException

startInfo パラメーターの FileName プロパティにファイル名が指定されませんでした。

または

startInfo パラメーターの UseShellExecute プロパティは true であり、RedirectStandardInput、RedirectStandardOutput、または RedirectStandardError プロパティも true です。

または

startInfo パラメーターの UseShellExecute プロパティは true であり、UserName プロパティは null でも空でもないか、または Password プロパティは null ではありません。

ArgumentNullException

startInfo パラメーターが null です。

ObjectDisposedException

プロセス オブジェクトは既には破棄されています。

Win32Exception

関連付けられているファイルを開いているときにエラーが発生しました。

または

startInfo パラメーターの FileName プロパティに指定されたファイルを見つけることができませんでした。

または

引数の長さとプロセスへの完全パスの長さの合計が、2080 文字を超えています。 この例外に関連付けられているエラー メッセージは、"システム呼び出しに渡されるデータ領域が小さすぎます" または "アクセスが拒否されました" のいずれかです。

PlatformNotSupportedException

メソッドはシェルがサポートされていない Nano Server (.NET Core のみ) などのオペレーティング システムではサポートされていません。

例

次の例では、最初にインターネット エクスプローラーのインスタンスを生成し、ブラウザーに [お気に入り] フォルダーの内容を表示します。 その後、インターネット エクスプローラーの他のインスタンスを起動し、特定のページまたはサイトを表示します。 最後に、特定のサイトに移動中にウィンドウが最小化された状態でインターネット エクスプローラーを開始します。

このメソッドのその他の使用例については、 クラスの個々のプロパティを ProcessStartInfo 参照してください。

#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 しいオブジェクトに関連付けます。

重要

信頼されていないデータを指定してこのメソッドを呼び出すことは、セキュリティ上のリスクが伴います。 このメソッドは信頼されたデータでのみ呼び出してください。 詳細については、「 すべての入力を検証する」を参照してください。

注意

開始する実行可能ファイルのアドレスが URL の場合、プロセスは開始されず、 null 返されます。

このオーバーロードを使用すると、最初に新しい Process インスタンスを作成せずにプロセスを開始できます。 パラメーターでこのオーバーロードを ProcessStartInfo 使用することは、新しい Process インスタンスを作成し、その StartInfo プロパティを設定し、インスタンスの を呼び出す Start 明示的な手順に Process 代わる方法です。

パラメーターとして インスタンスを ProcessStartInfo 使用すると、呼び出し Start に渡される内容を最も制御して を呼び出してプロセスを開始できます。 ファイル名またはファイル名と引数のみを渡す必要がある場合は、新しい ProcessStartInfo インスタンスを作成する必要はありませんが、これはオプションです。 設定する必要がある唯一 Process.StartInfo のプロパティは、 FileName プロパティです。 プロパティは FileName 実行可能ファイルを表す必要はありません。 拡張子がシステムにインストールされているアプリケーションに関連付けられている任意のファイルの種類を指定できます。 たとえば、FileNameメモ帳などのエディターにテキスト ファイルを関連付ける場合はプロパティに .txt 拡張子を付けたり、Microsoft Word などのワープロ ツールに .doc ファイルを関連付けた場合は .doc 拡張子を持つことができます。

ClickOnce アプリケーションを起動するには、最初にアプリケーションをインストールした場所 (Web アドレスなど) を指定します。 ハード ドライブにインストールされている場所を指定して ClickOnce アプリケーションを起動しないでください。

ProcessStartInfo.UserNameインスタンスの StartInfo プロパティと ProcessStartInfo.Password プロパティが設定されている場合、アンマネージCreateProcessWithLogonW関数が呼び出され、プロパティ値が true または プロパティ値である場合ProcessStartInfo.CreateNoWindowでも、新しいウィンドウでプロセスがProcessStartInfo.WindowStyleProcessWindowStyle.Hidden開始されます。 プロパティが ProcessStartInfo.Domain の場合、ProcessStartInfo.UserNameプロパティは nullUPN 形式である必要があります。ユーザー@DNS_domain_name。

他のオーバーロードとは異なり、パラメーターを持たない の Start オーバーロードはメンバーではありません static 。 インスタンスを既に作成 Process し、開始情報 (ファイル名を含む) を指定し、プロセス リソースを開始して既存 Process のインスタンスに関連付ける場合は、そのオーバーロードを使用します。 既存のコンポーネントのプロセスを static 開始するのではなく、新しい Process コンポーネントを作成する場合は、いずれかのオーバーロードを使用します。 このオーバーロードとパラメーターのないオーバーロードの両方を使用すると、インスタンスを使用してプロセス リソースの開始情報を ProcessStartInfo 指定できます。

システムでパス変数を引用符で囲んで宣言している場合、その場所で見つかるプロセスを開始するときに、そのパスを完全修飾する必要があります。 そうしないと、システムはそのパスを見つけられません。 たとえば、c:\mypath がパスに含まれておらず、それを path = %path%;"c:\mypath"` のように引用符を使用して追加した場合、c:\mypath 内の任意のプロセスを開始するときに、それを完全修飾する必要があります。

注意

ASP.NET Web ページとサーバー コントロール コードは、Web サーバー上の ASP.NET ワーカー プロセスのコンテキストで実行されます。 ASP.NET Web ページまたはサーバー コントロールで メソッドを使用 Start すると、アクセス許可が制限された Web サーバー上で新しいプロセスが実行されます。 このプロセスは、クライアント ブラウザーと同じコンテキストでは開始されず、ユーザー デスクトップにアクセスできません。

を使用 Start してプロセスを開始するたびに、プロセスを閉じる必要があるか、システム リソースが失われるリスクがあります。 または Killを使用してプロセスをCloseMainWindow閉じます。 そのプロパティを使用してHasExited、プロセスが既に閉じているかどうかをチェックできます。

ここでは、マネージド スレッドでのアパートメントの状態に関する注意が必要です。 が true パラメーターのstartInfo場合UseShellExecuteは、 メソッドに 属性[STAThread]を設定して、アプリケーションにスレッド モデルをmain()設定していることを確認します。 それ以外の場合は、マネージド スレッドを unknown 状態にするか、状態にMTA置くことができます。後者は とtrue競合しますUseShellExecute。 一部のメソッドでは、アパートメントの状態が である unknown必要はありません。 状態が明示的に設定されていない場合、アプリケーションでこのようなメソッドが検出されると、既定値は に MTA設定され、一度設定されると、アパートメントの状態を変更することはできません。 ただし、 MTA オペレーティング システム シェルがスレッドを管理しているときに例外がスローされます。

こちらもご覧ください

• StartInfo
• FileName
• ProcessStartInfo
• CloseMainWindow()
• Kill()

Start()

ソース:

Process.cs

この Process コンポーネントの StartInfo プロパティで指定されたプロセス リソースを起動 (または再利用) し、コンポーネントに関連付けます。

public:
 bool Start();

[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
[System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")]
public bool Start ();

[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
[<System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")>]
member this.Start : unit -> bool

Public Function Start () As Boolean

戻り値

Boolean

プロセス リソースが起動された場合は true。新しいプロセス リソースが起動されなかった場合は false (既存のプロセスを再利用した場合など)。

属性

UnsupportedOSPlatformAttribute SupportedOSPlatformAttribute

例外

InvalidOperationException

Process コンポーネントの StartInfo にファイル名が指定されませんでした。

または

UseShellExecute プロパティの StartInfo メンバーは true ですが、 RedirectStandardInput、 RedirectStandardOutput、または RedirectStandardError は trueです。

Win32Exception

関連付けられているファイルを開いているときにエラーが発生しました。

ObjectDisposedException

プロセス オブジェクトは既には破棄されています。

PlatformNotSupportedException

メソッドはシェルがサポートされていない Nano Server (.NET Core のみ) などのオペレーティング システムではサポートされていません。

例

次の例では、 クラスのインスタンスを Process 使用してプロセスを開始します。

#using <System.dll>
using namespace System;
using namespace System::Diagnostics;
using namespace System::ComponentModel;

int main()
{
    Process^ myProcess = gcnew Process;

    try
    {
        myProcess->StartInfo->UseShellExecute = false;
        // You can start any process, HelloWorld is a do-nothing example.
        myProcess->StartInfo->FileName = "C:\\HelloWorld.exe";
        myProcess->StartInfo->CreateNoWindow = true;
        myProcess->Start();
        // This code assumes the process you are starting will terminate itself. 
        // Given that it is started without a window so you cannot terminate it 
        // on the desktop, it must terminate itself or you can do it programmatically
        // from this application using the Kill method.
    }
    catch ( Exception^ e ) 
    {
        Console::WriteLine( e->Message );
    }
}

using System;
using System.Diagnostics;
using System.ComponentModel;

namespace MyProcessSample
{
    class MyProcess
    {
        public static void Main()
        {
            try
            {
                using (Process myProcess = new Process())
                {
                    myProcess.StartInfo.UseShellExecute = false;
                    // You can start any process, HelloWorld is a do-nothing example.
                    myProcess.StartInfo.FileName = "C:\\HelloWorld.exe";
                    myProcess.StartInfo.CreateNoWindow = true;
                    myProcess.Start();
                    // This code assumes the process you are starting will terminate itself.
                    // Given that it is started without a window so you cannot terminate it
                    // on the desktop, it must terminate itself or you can do it programmatically
                    // from this application using the Kill method.
                }
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }
    }
}

Imports System.Diagnostics
Imports System.ComponentModel

Namespace MyProcessSample
    Class MyProcess
        Public Shared Sub Main()
            Try
                Using myProcess As New Process()

                    myProcess.StartInfo.UseShellExecute = False
                    ' You can start any process, HelloWorld is a do-nothing example.
                    myProcess.StartInfo.FileName = "C:\\HelloWorld.exe"
                    myProcess.StartInfo.CreateNoWindow = True
                    myProcess.Start()
                    ' This code assumes the process you are starting will terminate itself. 
                    ' Given that it is started without a window so you cannot terminate it 
                    ' on the desktop, it must terminate itself or you can do it programmatically
                    ' from this application using the Kill method.
                End Using
            Catch e As Exception
                Console.WriteLine((e.Message))
            End Try
        End Sub
    End Class
End Namespace

注釈

このオーバーロードを使用して、プロセス リソースを開始し、それを現在 Process のコンポーネントに関連付けます。 戻り値 true は、新しいプロセス リソースが開始されたことを示します。 プロパティのメンバーStartInfoによってFileName指定されたプロセス リソースがコンピューターで既に実行されている場合、追加のプロセス リソースは開始されません。 代わりに、実行中のプロセス リソースが再利用され、 false 返されます。

ClickOnce アプリケーションを起動するには、最初にアプリケーションをインストールした場所 (Web アドレスなど) を指定します。 ハード ドライブにインストールされている場所を指定して ClickOnce アプリケーションを起動しないでください。

重要

信頼されていないデータを指定してこのオブジェクトのインスタンスを使用することは、セキュリティ上のリスクが伴います。 このオブジェクトは信頼されたデータでのみ使用してください。 詳細については、「 すべての入力を検証する」を参照してください。

注意

Visual Studio を使用している場合、メソッドの Start このオーバーロードは、コンポーネントをデザイナーにドラッグ Process した後にコードに挿入するオーバーロードです。 ウィンドウを Properties 使用してカテゴリを StartInfo 展開し、適切な値を FileName プロパティに書き込みます。 変更はフォーム InitializeComponent のプロシージャに表示されます。

のこのオーバーロード Start はメソッドではありません static 。 クラスの Process インスタンスから呼び出す必要があります。 を呼び出すStart前に、最初にこのProcessインスタンスのプロパティ情報を指定StartInfoする必要があります。この情報は、開始するプロセス リソースを決定するために使用されるためです。

メソッドの他の Start オーバーロードはメンバーです static 。 メソッドのこれらのオーバーロードを呼び出す前に、 Process コンポーネントのインスタンスを作成する必要はありません。 代わりに、 クラス自体をProcess呼び出Startすことができます。プロセスが開始された場合は、新しいProcessコンポーネントが作成されます。 または、 null プロセスが再利用された場合に が返されます。 プロセス リソースは、 メソッドによって返される新しい Process コンポーネントに自動的に Start 関連付けられます。

メンバーをStartInfo使用して、Windows Start メニューのRunダイアログ ボックスの機能を複製できます。 コマンド ラインに入力できるものは、 プロパティに適切な値 StartInfo を設定することで開始できます。 設定する必要がある唯一 StartInfo のプロパティは、 FileName プロパティです。 プロパティは FileName 実行可能ファイルである必要はありません。 拡張子がシステムにインストールされているアプリケーションに関連付けられている任意のファイルの種類を指定できます。 たとえば、FileNameメモ帳などのエディターにテキスト ファイルを関連付ける場合はプロパティに .txt 拡張子を付けたり、Microsoft Word などのワープロ ツールに .doc ファイルを関連付けた場合は .doc 拡張子を持つことができます。

コマンド ラインでは、特定の種類のファイルに対して実行するアクションを指定できます。 たとえば、ドキュメントを印刷したり、テキスト ファイルを編集したりできます。 プロパティの メンバーを使用して、 Verb これらのアクションを StartInfo 指定します。 他の種類のファイルの場合は、ダイアログ ボックスからファイルを起動するときにコマンド ライン引数を Run 指定できます。 たとえば、 としてブラウザーを指定する場合は、URL を引数として FileName渡すことができます。 これらの引数は、プロパティArgumentsの StartInfo メンバーで指定できます。

システムでパス変数を引用符で囲んで宣言している場合、その場所で見つかるプロセスを開始するときに、そのパスを完全修飾する必要があります。 そうしないと、システムはそのパスを見つけられません。 たとえば、c:\mypath がパスに含まれておらず、それを path = %path%;"c:\mypath"` のように引用符を使用して追加した場合、c:\mypath 内の任意のプロセスを開始するときに、それを完全修飾する必要があります。

注意

ASP.NET Web ページとサーバー コントロール コードは、Web サーバー上の ASP.NET ワーカー プロセスのコンテキストで実行されます。 ASP.NET Web ページまたはサーバー コントロールで メソッドを使用 Start すると、アクセス許可が制限された Web サーバー上で新しいプロセスが実行されます。 このプロセスは、クライアント ブラウザーと同じコンテキストでは開始されず、ユーザー デスクトップにアクセスできません。

を使用 Start してプロセスを開始するたびに、プロセスを閉じる必要があるか、システム リソースが失われるリスクがあります。 または Killを使用してプロセスをCloseMainWindow閉じます。 そのプロパティを使用してHasExited、プロセスが既に閉じているかどうかをチェックできます。

ここでは、マネージド スレッドでのアパートメントの状態に関する注意が必要です。 がtrueプロセス コンポーネントの StartInfo プロパティにある場合UseShellExecuteは、 メソッドに 属性[STAThread]を設定して、アプリケーションにスレッド モデルをmain()設定していることを確認します。 それ以外の場合は、マネージド スレッドを unknown 状態にするか、状態にMTA置くことができます。後者は とtrue競合しますUseShellExecute。 一部のメソッドでは、アパートメントの状態が である unknown必要はありません。 状態が明示的に設定されていない場合、アプリケーションでこのようなメソッドが検出されると、既定値は に MTA設定され、一度設定されると、アパートメントの状態を変更することはできません。 ただし、 MTA オペレーティング システム シェルがスレッドを管理しているときに例外がスローされます。

こちらもご覧ください

• StartInfo
• FileName
• ProcessStartInfo
• CloseMainWindow()
• Kill()

Start(String, IEnumerable<String>)

ソース:

Process.cs

アプリケーションの名前とコマンド ライン引数のセットを指定してプロセス リソースを起動します。

public:
 static System::Diagnostics::Process ^ Start(System::String ^ fileName, System::Collections::Generic::IEnumerable<System::String ^> ^ arguments);

[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
[System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")]
public static System.Diagnostics.Process Start (string fileName, System.Collections.Generic.IEnumerable<string> arguments);

[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
[<System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")>]
static member Start : string * seq<string> -> System.Diagnostics.Process

Public Shared Function Start (fileName As String, arguments As IEnumerable(Of String)) As Process

パラメーター

fileName

String

プロセスで実行する文書またはアプリケーション ファイルの名前。

arguments

IEnumerable<String>

プロセスを起動するときに渡すコマンド ライン引数。

戻り値

Process

プロセス リソースに関連付けられている新しい Process。プロセス リソースが起動されていない場合は null。

属性

UnsupportedOSPlatformAttribute SupportedOSPlatformAttribute

注釈

各引数は、必要に応じて自動的にエスケープされます。

重要

信頼されていないデータを指定してこのメソッドを呼び出すことは、セキュリティ上のリスクが伴います。 このメソッドは信頼されたデータでのみ呼び出してください。 詳細については、「 すべての入力を検証する」を参照してください。