Process.SynchronizingObject Vlastnost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

netstandard.dll, System.Diagnostics.Process.dll

Zdroj:

Process.cs

Získá nebo nastaví objekt použitý k zařazování volání obslužné rutiny události, které jsou vydány v důsledku události ukončení procesu.

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

Hodnota vlastnosti

ISynchronizeInvoke

Používá ISynchronizeInvoke se k zařazování volání obslužné rutiny události, která jsou vydána v důsledku Exited události v procesu.

Příklady

    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

Poznámky

Pokud SynchronizingObject je null, metody, které zpracovávají Exited událost jsou volána ve vlákně ze systémového fondu vláken. Další informace o systémových fondech vláken naleznete v tématu ThreadPool.

Exited Pokud je událost zpracována vizuální komponentou Modelu Windows Forms, jako Buttonje například , přístup ke komponentě prostřednictvím systémového fondu vláken nemusí fungovat nebo může vést k výjimce. Vyhněte se tomu tím, že nastavíte SynchronizingObject komponentu Modelu Windows Forms, která způsobí volání metod zpracování Exited události ve stejném vlákně, na kterém byla komponenta vytvořena.

Process Pokud se používá uvnitř sady Visual Studio 2005 v návrháři Windows Forms, SynchronizingObject je automaticky nastaven na ovládací prvek, který obsahuje Process. Pokud například umístíte Process návrháře ( Form1 který dědí z Form) SynchronizingObject vlastnost Process je nastavena na instanci 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

Tato vlastnost je obvykle nastavena, když je komponenta umístěna uvnitř ovládacího prvku nebo formuláře, protože tyto komponenty jsou vázány na konkrétní vlákno.

Viz také

• SynchronizingObject