Process.SynchronizingObject プロパティ

定義

名前空間:

System.Diagnostics

アセンブリ:

netstandard.dll, System.Diagnostics.Process.dll

ソース:

Process.cs

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

public:
 property System::ComponentModel::ISynchronizeInvoke ^ SynchronizingObject { System::ComponentModel::ISynchronizeInvoke ^ get(); void set(System::ComponentModel::ISynchronizeInvoke ^ value); };

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

member this.SynchronizingObject : System.ComponentModel.ISynchronizeInvoke with get, set

Public Property SynchronizingObject As ISynchronizeInvoke

プロパティ値

ISynchronizeInvoke

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

例

    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
{
}

    Private button1 As MyButton
    Private Sub button1_Click(sender As Object, e As EventArgs)
        Using myProcess As New Process()
            Dim myProcessStartInfo As New ProcessStartInfo("mspaint")
            myProcess.StartInfo = myProcessStartInfo
            myProcess.Start()
            AddHandler myProcess.Exited, AddressOf 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()
        End Using
    End Sub

    Private Sub MyProcessExited(source As Object, e As EventArgs)
        MessageBox.Show("The process has exited.")
    End Sub
End Class

Public Class MyButton
    Inherits Button

End Class

注釈

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

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

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

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;

process1.StartInfo.Domain = ""
process1.StartInfo.LoadUserProfile = False
process1.StartInfo.Password = Nothing
process1.StartInfo.StandardErrorEncoding = Nothing
process1.StartInfo.StandardOutputEncoding = Nothing
process1.StartInfo.UserName = ""
process1.SynchronizingObject = Me

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

こちらもご覧ください

• SynchronizingObject