Process.SynchronizingObject Eigenschap

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

[System.ComponentModel.Browsable(false)]
public System.ComponentModel.ISynchronizeInvoke SynchronizingObject { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.SynchronizingObject : System.ComponentModel.ISynchronizeInvoke with get, set

Public Property SynchronizingObject As ISynchronizeInvoke

Waarde van eigenschap

De ISynchronizeInvoke aanroepen van marshal event handler die worden uitgegeven als gevolg van een Exited gebeurtenis in het proces.

Kenmerken

BrowsableAttribute

Voorbeelden

    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

Opmerkingen

Wanneer SynchronizingObject dit het geval is null, worden methoden voor het afhandelen van de Exited gebeurtenis aangeroepen op een thread uit de systeemthreadgroep. Zie voor meer informatie over systeemthreadgroepen ThreadPool.

Wanneer de gebeurtenis Exited wordt verwerkt door een visueel Windows Forms onderdeel, zoals een Button, werkt het openen van het onderdeel via de systeemthreadgroep mogelijk niet of kan dit leiden tot een uitzondering. Vermijd dit door SynchronizingObject in te stellen op een Windows Forms-onderdeel, waardoor de methoden die de Exited gebeurtenis verwerken, worden aangeroepen op dezelfde thread waarop het onderdeel is gemaakt.

Als de Process in Visual Studio 2005 in een Windows Forms designer wordt gebruikt, wordt SynchronizingObject automatisch ingesteld op het besturingselement dat de Process bevat. Als u bijvoorbeeld een Process ontwerpfunctie plaatst voor Form1 (waarvan de eigenschap Process wordt overgenomen) FormSynchronizingObject is ingesteld op het exemplaar vanForm1:

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

Deze eigenschap wordt doorgaans ingesteld wanneer het onderdeel in een besturingselement of formulier wordt geplaatst, omdat deze onderdelen zijn gebonden aan een specifieke thread.

Zie ook

• SynchronizingObject