Process.SynchronizingObject プロパティ

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.Process.dll

ソース:

Process.cs

プロセス終了イベントの結果として発行されるイベント ハンドラー呼び出しをマーシャリングするために使用するオブジェクトを取得または設定します。

public System.ComponentModel.ISynchronizeInvoke? SynchronizingObject { get; set; }

プロパティ値

ISynchronizeInvoke

プロセスの Exited イベントの結果として発行されるイベント ハンドラー呼び出しをマーシャリングするために使用する ISynchronizeInvoke。

例

    private MyButton button1;
    private void button1_Click(object sender, System.EventArgs e)
    {
        using (Process myProcess = new Process())
        {
            ProcessStartInfo myProcessStartInfo = new ProcessStartInfo("mspaint");
            myProcess.StartInfo = myProcessStartInfo;
            myProcess.Start();
            myProcess.Exited += new EventHandler(MyProcessExited);
            // Set 'EnableRaisingEvents' to true, to raise 'Exited' event when process is terminated.
            myProcess.EnableRaisingEvents = true;
            // Set method handling the exited event to be called  ;
            // on the same thread on which MyButton was created.
            myProcess.SynchronizingObject = button1;
            MessageBox.Show("Waiting for the process 'mspaint' to exit....");
            myProcess.WaitForExit();
        }
    }
    private void MyProcessExited(Object source, EventArgs e)
    {
        MessageBox.Show("The process has exited.");
    }
}

public class MyButton : Button
{
}

注釈

が nullの場合SynchronizingObject、イベントをExited処理するメソッドは、システム スレッド プールのスレッドで呼び出されます。 システム スレッド プールの詳細については、「」を参照してください ThreadPool。

ExitedなどのButtonビジュアル Windows フォーム コンポーネントによってイベントが処理されると、システム スレッド プールを介してコンポーネントにアクセスできないか、例外が発生する可能性があります。 これを回避するには、Windows フォーム コンポーネントを設定SynchronizingObjectします。これにより、コンポーネントが作成されたのと同じスレッドでイベントを処理Exitedするメソッドが呼び出されます。

Processが visual Studio 2005 内でWindows フォーム デザイナーで使用されている場合、 SynchronizingObject は を含むコントロールに自動的に設定されますProcess。 たとえば、 (をForm継承する) のForm1デザイナーに を配置Processすると、 SynchronizingObject の Process プロパティは のForm1インスタンスに設定されます。

process1.StartInfo.Domain = "";
process1.StartInfo.LoadUserProfile = false;
process1.StartInfo.Password = null;
process1.StartInfo.StandardErrorEncoding = null;
process1.StartInfo.StandardOutputEncoding = null;
process1.StartInfo.UserName = "";
process1.SynchronizingObject = this;

通常、このプロパティは、コンポーネントがコントロールまたはフォーム内に配置されるときに設定されます。これらのコンポーネントは特定のスレッドにバインドされるためです。

適用対象

こちらもご覧ください

• SynchronizingObject